C2C

Get C2C Trade History (USER_DATA)

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

get/sapi/v1/c2c/orderMatch/listUserOrderHistory

Query parameters

tradeType'BUY' | 'SELL' required

startTimestampinteger

UTC timestamp in ms

endTimestampinteger

UTC timestamp in ms

pageinteger

Example:1

Default 1

rowsinteger

default 100, max 100

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Trades history

codestring required

messagestring required

totalinteger required

successboolean required

Example response

{
  "code": "000000",
  "message": "success",
  "data": [
    {
      "orderNumber": "20219644646554779648",
      "advNo": "11218246497340923904",
      "tradeType": "SELL",
      "asset": "BUSD",
      "fiat": "CNY",
      "fiatSymbol": "￥",
      "amount": "5000.00000000",
      "totalPrice": "33400.00000000",
      "unitPrice": "6.68",
      "orderStatus": "COMPLETED",
      "createTime": 1619361369000,
      "commission": "0",
      "counterPartNickName": "ab***",
      "advertisementRole": "TAKER"
    }
  ],
  "total": 1
}

Changes

Changed in 2 of the 26 revisions of this API.723

Mar 4, 2022f1d8926e955a1See the full diff
- ▲
  the query request parameter tradeType became required
  request-parameter-became-required
Oct 25, 2021a484ce871a72623See the full diff
- ▲
  for the query request parameter endTimestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter page, the type/format was changed from integer/ to integer/int32
  request-parameter-type-changed
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter rows, the type/format was changed from integer/ to integer/int32
  request-parameter-type-changed
- ▲
  for the query request parameter startTimestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  the response property code became required for the status 200
  response-property-became-required
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property data became required for the status 200
  response-property-became-required
- ○
  the response property data/items/advNo became required for the status 200
  response-property-became-required
- ○
  the response property data/items/advertisementRole became required for the status 200
  response-property-became-required
- ○
  the response property data/items/amount became required for the status 200
  response-property-became-required
- ○
  the response property data/items/asset became required for the status 200
  response-property-became-required
- ○
  the response property data/items/commission became required for the status 200
  response-property-became-required
- ○
  the response property data/items/counterPartNickName became required for the status 200
  response-property-became-required
- ○
  the response property data/items/createTime became required for the status 200
  response-property-became-required
- ○
  the response property data/items/fiat became required for the status 200
  response-property-became-required
- ○
  the response property data/items/fiatSymbol became required for the status 200
  response-property-became-required
- ○
  the response property data/items/orderNumber became required for the status 200
  response-property-became-required
- ○
  the response property data/items/orderStatus became required for the status 200
  response-property-became-required
- ○
  the response property data/items/totalPrice became required for the status 200
  response-property-became-required
- ○
  the response property data/items/tradeType became required for the status 200
  response-property-became-required
- ○
  the response property data/items/unitPrice became required for the status 200
  response-property-became-required
- ○
  the response property message became required for the status 200
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property success became required for the status 200
  response-property-became-required
- ○
  the response property total became required for the status 200
  response-property-became-required

Full history