Get Pay Trade History

API Description

Get Pay Trade History

HTTP Request

GET /sapi/v1/pay/transactions

Request Weight(UID)

3000

Request Parameters

Name	Type	Mandatory	Description
startTime	LONG	NO
endTime	LONG	NO
limit	INT	NO	default 100, max 100
recvWindow	LONG	NO
timestamp	LONG	YES

• If startTime and endTime are not sent, the recent 90 days' data will be returned.

• The max interval between startTime and endTime is 90 days.

• Support for querying orders within the last 18 months.

• For payerInfo and receiverInfo，there are different return values in different orderTypes.

  • Sender's perspective when orderType is C2C
    • payerInfo : binanceId
    • receiverInfo : name, binanceId/accountId/email/countryCode/phoneNumber/mobileCode (based on user input)
  • Receiver's perspective when orderType is C2C
    • payerInfo : name, accountId
    • receiverInfo : binanceId
  • Sender's perspective when orderType is CRYPTO_BOX
    • payerInfo : binanceId
    • receiverInfo : name(the value is always "Crypto Box")
  • Receiver's perspective when orderType is CRYPTO_BOX
    • payerInfo : name, accountId
    • receiverInfo : binanceId
  • Sender's perspective when orderType is PAY
    • payerInfo : binanceId
    • receiverInfo : name
  • Receiver's perspective when orderType is PAY
    • payerInfo : name, accountId
    • receiverInfo : binanceId, name
  • Sender's perspective when orderType is PAY_REFUND
    • payerInfo : binanceId, name
    • receiverInfo : name, accountId
  • Receiver's perspective when orderType is PAY_REFUND
    • payerInfo : name
    • receiverInfo : binanceId
  • Sender's perspective when orderType is PAYOUT
    • payerInfo : binanceId, name
    • receiverInfo : name, accountId
  • Receiver's perspective when orderType is PAYOUT
    • payerInfo : name
    • receiverInfo : binanceId
  • Receiver's perspective when orderType is CRYPTO_BOX_RF
    • payerInfo : name(the value is always "Crypto Box")
    • receiverInfo : binanceId
  • Sender's perspective when orderType is REMITTANCE
    • payerInfo : binanceId
    • receiverInfo : name, institutionName, cardNumber, digitalWalletId

Response Example

{
   "code": "000000",
   "message": "success",
   "data": [
   {
       "orderType": "C2C", // Enum：PAY(C2B Merchant Acquiring Payment), PAY_REFUND(C2B Merchant Acquiring Payment,refund), C2C(C2C Transfer Payment),CRYPTO_BOX(Crypto box), CRYPTO_BOX_RF(Crypto Box, refund), C2C_HOLDING(Transfer to new Binance user), C2C_HOLDING_RF(Transfer to new Binance user,refund), PAYOUT(B2C Disbursement Payment), REMITTANCE（Send cash)
       "transactionId": "M_P_71505104267788288", 
       "transactionTime": 1610090460133, //trade timestamp
       "amount": "23.72469206", //order amount(up to 8 decimal places), positive is income, negative is expenditure
       "currency": "BNB",
       "walletType": 1, //main wallet type, 1 for funding wallet, 2 for spot wallet, 3 for fiat wallet, 4 or 6 for card payment, 5 for earn wallet
       "walletTypes": [1,2], //array format，there are multiple values when using combination payment
       "fundsDetail": [ // details
               {
                "currency": "USDT", //asset
                "amount": "1.2",
                "walletAssetCost":[ //details of asset cost per wallet
                    {"1":"0.6"},
                    {"2":"0.6"}
                ]
               },
               {
                 "currency": "ETH",
                 "amount": "0.0001",
                 "walletAssetCost":[
                    {"1":"0.00005"},
                    {"2":"0.00005"}
                 ]
               }
          ],
       "payerInfo":{
               "name":"Jack", //nickname or merchant name
               "type":"USER", //account type，USER for personal，MERCHANT for merchant
               "binanceId":"12345678", //binance uid
               "accountId":"67736251" //binance pay id
           },
       "receiverInfo":{
               "name":"Alan", //nickname or merchant name
               "type":"MERCHANT", //account type，USER for personal，MERCHANT for merchant
               "email":"alan@binance.com", //email
               "binanceId":"34355667", //binance uid
               "accountId":"21326891", //binance pay id
               "countryCode":"1", //International area code
               "phoneNumber":"8057651210",
               "mobileCode":"US", //country code
               "extend": { //extension field
                    "institutionName": "",
                    "cardNumber": "",  
                    "digitalWalletId": ""
               }
           }
     }
   ],
  "success": true
}