C2C REST API | Binance Developer Docs

Endpoint

Download schema

Get C2C Trade History (USER_DATA)

Get C2C Trade History

GET

/sapi/v1/c2c/orderMatch/listUserOrderHistory

https://api.binance.com

Get C2C Trade History (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Get C2C Trade History (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get C2C Trade History (USER_DATA) › Query Parameters

tradeType

string · enum

Trade side filter

Enum values:

BUY

SELL

Example: BUY

startTimestamp

integer · int64

Example: 1770736694138

endTimestamp

integer · int64

Example: 1770736694138

page

integer · int64

Page number

Example: 1

Default: 1

rows

integer · int64 · max: 100

Number of records per page

Example: 100

Default: 100

Get C2C Trade History (USER_DATA) › Responses

200

Get C2C Trade History

code

string

API response code. "000000" indicates success.

Example: 000000

message

string

Response message.

Example: success

object[]

orderNumber

string

Example: 20219644646554779648

advNo

string

Example: 11218246497340923904

tradeType

string

Example: SELL

asset

string

Example: BUSD

fiat

string

Example: CNY

fiatSymbol

string

Example: ￥

amount

string

Quantity (in Crypto)

Example: 5000.00000000

totalPrice

string

Total order amount in fiat

Example: 33400.00000000

unitPrice

string

Unit Price (in Fiat)

Example: 6.68

orderStatus

string · enum

Enum values:

PENDING

TRADING

BUYER_PAYED

DISTRIBUTING

COMPLETED

IN_APPEAL

CANCELLED

CANCELLED_BY_SYSTEM

Example: COMPLETED

createTime

integer · int64

Order creation timestamp in milliseconds

Example: 1619361369000

commission

string

Transaction Fee (in Crypto)

Example: 0

counterPartNickName

string

Counterparty nickname

Example: 阿涛❤***

payMethodName

string

Identifier of the payment method

Example: BANK

additionalKycVerify

integer · int64

KYC verification status. 0: not required, 1: not verified, 2: verified

Example: 0

takerCommissionRate

string

Taker commission rate

Example: 0

takerCommission

string

Taker commission amount

Example: 0

takerAmount

string

Taker trade amount

Example: 343.4

advertisementRole

string · enum

Enum values:

MAKER

TAKER

Example: TAKER

total

integer · int64

Total number of records

Example: 1

success

boolean

Whether request is successful

Example: true

GET/sapi/v1/c2c/orderMatch/listUserOrderHistory

curl --request GET \
  --url https://api.binance.com/sapi/v1/c2c/orderMatch/listUserOrderHistory \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "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": "阿涛❤***",
      "payMethodName": "BANK",
      "additionalKycVerify": 0,
      "takerCommissionRate": "0",
      "takerCommission": "0",
      "takerAmount": "343.4",
      "advertisementRole": "TAKER"
    }
  ],
  "total": 1,
  "success": true
}

json

application/json

Get C2C Trade History (USER_DATA)

Get C2C Trade History

GET

/sapi/v1/c2c/orderMatch/listUserOrderHistory

https://api.binance.com

Get C2C Trade History (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Get C2C Trade History (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get C2C Trade History (USER_DATA) › Query Parameters

tradeType

string · enum

Trade side filter

Enum values:

BUY

SELL

Example: BUY

startTimestamp

integer · int64

Example: 1770736694138

endTimestamp

integer · int64

Example: 1770736694138

page

integer · int64

Page number

Example: 1

Default: 1

rows

integer · int64 · max: 100

Number of records per page

Example: 100

Default: 100

Get C2C Trade History (USER_DATA) › Responses

200

Get C2C Trade History

code

string

API response code. "000000" indicates success.

Example: 000000

message

string

Response message.

Example: success

object[]

orderNumber

string

Example: 20219644646554779648

advNo

string

Example: 11218246497340923904

tradeType

string

Example: SELL

asset

string

Example: BUSD

fiat

string

Example: CNY

fiatSymbol

string

Example: ￥

amount

string

Quantity (in Crypto)

Example: 5000.00000000

totalPrice

string

Total order amount in fiat

Example: 33400.00000000

unitPrice

string

Unit Price (in Fiat)

Example: 6.68

orderStatus

string · enum

Enum values:

PENDING

TRADING

BUYER_PAYED

DISTRIBUTING

COMPLETED

IN_APPEAL

CANCELLED

CANCELLED_BY_SYSTEM

Example: COMPLETED

createTime

integer · int64

Order creation timestamp in milliseconds

Example: 1619361369000

commission

string

Transaction Fee (in Crypto)

Example: 0

counterPartNickName

string

Counterparty nickname

Example: 阿涛❤***

payMethodName

string

Identifier of the payment method

Example: BANK

additionalKycVerify

integer · int64

KYC verification status. 0: not required, 1: not verified, 2: verified

Example: 0

takerCommissionRate

string

Taker commission rate

Example: 0

takerCommission

string

Taker commission amount

Example: 0

takerAmount

string

Taker trade amount

Example: 343.4

advertisementRole

string · enum

Enum values:

MAKER

TAKER

Example: TAKER

total

integer · int64

Total number of records

Example: 1

success

boolean

Whether request is successful

Example: true