---
title: "Get C2C Trade History (USER_DATA)"
method: GET
path: "/sapi/v1/c2c/orderMatch/listUserOrderHistory"
tags: ["C2C"]
---

# Get C2C Trade History (USER_DATA)

`GET /sapi/v1/c2c/orderMatch/listUserOrderHistory`

- If startTimestamp and endTimestamp are not sent, the recent 30-day data will be returned.
- The max interval between startTimestamp and endTimestamp is 30 days.

Weight(IP): 1

## Query parameters

- `tradeType` 'BUY' | 'SELL', required
- `startTimestamp` integer
- `endTimestamp` integer
- `page` integer
- `rows` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Trades history

- object
  - `code` string, required
  - `message` string, required
  - `data` object[], required
    - `orderNumber` string, required
    - `advNo` string, required
    - `tradeType` string, required
    - `asset` string, required
    - `fiat` string, required
    - `fiatSymbol` string, required
    - `amount` string, required — Quantity (in Crypto)
    - `totalPrice` string, required
    - `unitPrice` string, required — Unit Price (in Fiat)
    - `orderStatus` string, required — PENDING, TRADING, BUYER_PAYED, DISTRIBUTING, COMPLETED, IN_APPEAL, CANCELLED, CANCELLED_BY_SYSTEM
    - `createTime` integer, required
    - `commission` string, required — Transaction Fee (in Crypto)
    - `counterPartNickName` string, required
    - `advertisementRole` string, required
  - `total` integer, required
  - `success` boolean, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Request

## Changes

- **2022-03-04** `f1d8926e955a` — 1 breaking
  - the `query` request parameter `tradeType` became required
- **2021-10-25** `a484ce871a72` — 6 breaking, 23 info
  - for the `query` request parameter `endTimestamp`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `page`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - for the `query` request parameter `recvWindow`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `rows`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - …25 more

[Change history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/c2c/orderMatch/listUserOrderHistory/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) · [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/binance/binance-public-spot-api/revisions/0dd2f133e12d/schema)