Binance Pay REST API | Binance Developer Docs

Endpoint

Get Pay Trade History

GET

/sapi/v1/pay/transactions

https://api.binance.com

Get Pay Trade History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Pay Trade History › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get Pay Trade History › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

startTime

integer · int64

Start time in milliseconds.

Example: 1623319461670

endTime

integer · int64

End time in milliseconds.

Example: 1641782889000

limit

integer · int64 · max: 100

Number of records to return.

Example: 100

Default: 100

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds.

Example: 5000

Get Pay Trade History › Responses

200

Get Pay Trade History

code

string

Example: 000000

message

string

Example: success

object[]

orderType

string

Order type. Enum: PAY, PAY_REFUND, C2C, CRYPTO_BOX, CRYPTO_BOX_RF, C2C_HOLDING, C2C_HOLDING_RF, PAYOUT, REMITTANCE.

Example: C2C

transactionId

string

Transaction ID.

Example: M_P_71505104267788288

transactionTime

integer · int64

Trade timestamp.

Example: 1610090460133

amount

string

Order amount (up to 8 decimal places). Positive means income; negative means expenditure.

Example: 23.72469206

currency

string

Order asset.

Example: BNB

walletType

integer · int64

Main wallet type: 1=funding wallet, 2=spot wallet, 3=fiat wallet, 4 or 6=card payment, 5=earn wallet.

Example: 1

walletTypes

integer[]

Array format of wallet types. Multiple values may appear for combined payments.

object[]

Funds usage details.

currency

string

Asset.

Example: USDT

amount

string

Asset amount.

Example: 1.2

object

Asset cost details per wallet type. Keys are wallet type IDs (e.g. "1", "2"), values are cost amounts.

Example: {"1":"0.6","2":"0.6"}

Asset cost details per wallet type. Keys are wallet type IDs (e.g. "1", "2"), values are cost amounts.

string

object

name

string

Nickname or merchant name.

Example: Jack

type

string

Account type: USER for personal, MERCHANT for merchant.

Example: USER

binanceId

string

Binance UID.

Example: 12345678

object

name

string

Nickname or merchant name.

Example: Alan

type

string

Account type: USER for personal, MERCHANT for merchant.

Example: MERCHANT

email

string

Email.

Example: alan@binance.com

binanceId

string

Binance UID.

Example: 34355667

accountId

string

Binance Pay ID.

Example: 21326891

countryCode

string

International area code.

Example: 1

phoneNumber

string

Phone number.

Example: 8057651210

mobileCode

string

Country code.

Example: US

object

Extension fields.

institutionName

string

Bank name or digital wallet name.

Example:

cardNumber

string

Card number.

Example:

digitalWalletId

string

Digital wallet ID.

Example:

success

boolean

Example: true

GET/sapi/v1/pay/transactions

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/pay/transactions?timestamp=%3Cnumber%3E'

Example Responses

{
  "code": "000000",
  "message": "success",
  "data": [
    {
      "orderType": "C2C",
      "transactionId": "M_P_71505104267788288",
      "transactionTime": 1610090460133,
      "amount": "23.72469206",
      "currency": "BNB",
      "walletType": 1,
      "walletTypes": [
        1
      ],
      "fundsDetail": [
        {
          "currency": "USDT",
          "amount": "1.2",
          "walletAssetCost": {
            "1": "0.6",
            "2": "0.6"
          }
        }
      ],
      "payerInfo": {
        "name": "Jack",
        "type": "USER",
        "binanceId": "12345678"
      },
      "receiverInfo": {
        "name": "Alan",
        "type": "MERCHANT",
        "email": "alan@binance.com",
        "binanceId": "34355667",
        "accountId": "21326891",
        "countryCode": "1",
        "phoneNumber": "8057651210",
        "mobileCode": "US",
        "extend": {
          "institutionName": "",
          "cardNumber": "",
          "digitalWalletId": ""
        }
      }
    }
  ],
  "success": true
}

json

application/json

Get Pay Trade History

GET

/sapi/v1/pay/transactions

https://api.binance.com

Get Pay Trade History › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Pay Trade History › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get Pay Trade History › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

startTime

integer · int64

Start time in milliseconds.

Example: 1623319461670

endTime

integer · int64

End time in milliseconds.

Example: 1641782889000

limit

integer · int64 · max: 100

Number of records to return.

Example: 100

Default: 100

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds.

Example: 5000

Get Pay Trade History › Responses

200

Get Pay Trade History

code

string

Example: 000000

message

string

Example: success

object[]

orderType

string

Order type. Enum: PAY, PAY_REFUND, C2C, CRYPTO_BOX, CRYPTO_BOX_RF, C2C_HOLDING, C2C_HOLDING_RF, PAYOUT, REMITTANCE.

Example: C2C

transactionId

string

Transaction ID.

Example: M_P_71505104267788288

transactionTime

integer · int64

Trade timestamp.

Example: 1610090460133

amount

string

Order amount (up to 8 decimal places). Positive means income; negative means expenditure.

Example: 23.72469206

currency

string

Order asset.

Example: BNB

walletType

integer · int64

Main wallet type: 1=funding wallet, 2=spot wallet, 3=fiat wallet, 4 or 6=card payment, 5=earn wallet.

Example: 1

walletTypes

integer[]

Array format of wallet types. Multiple values may appear for combined payments.

object[]

Funds usage details.

currency

string

Asset.

Example: USDT

amount

string

Asset amount.

Example: 1.2

object

Asset cost details per wallet type. Keys are wallet type IDs (e.g. "1", "2"), values are cost amounts.

Example: {"1":"0.6","2":"0.6"}

Asset cost details per wallet type. Keys are wallet type IDs (e.g. "1", "2"), values are cost amounts.

string

object

name

string

Nickname or merchant name.

Example: Jack

type

string

Account type: USER for personal, MERCHANT for merchant.

Example: USER

binanceId

string

Binance UID.

Example: 12345678

object

name

string

Nickname or merchant name.

Example: Alan

type

string

Account type: USER for personal, MERCHANT for merchant.

Example: MERCHANT

email

string

Email.

Example: alan@binance.com

binanceId

string

Binance UID.

Example: 34355667

accountId

string

Binance Pay ID.

Example: 21326891

countryCode

string

International area code.

Example: 1

phoneNumber

string

Phone number.

Example: 8057651210

mobileCode

string

Country code.

Example: US

object

Extension fields.

institutionName

string

Bank name or digital wallet name.

Example:

cardNumber

string

Card number.

Example:

digitalWalletId

string

Digital wallet ID.

Example:

success

boolean

Example: true