Skip to main content

Get Merchant P2P orders

Frequency limit:10 times/1s (UID)

Description

Merchant queries P2P orders

HTTP request

  • GET /api/v2/p2p/orderList
Request Example
curl "https://api.bitget.com/api/v2/p2p/orderList?startTime=1659403328000&endTime=1659410528000&pageSize=20" \  -H "ACCESS-KEY:you apiKey" \  -H "ACCESS-SIGN:*" \  -H "ACCESS-PASSPHRASE:*" \  -H "ACCESS-TIMESTAMP:1659076670000" \  -H "locale:en-US" \  -H "Content-Type: application/json"

Request Parameter

ParameterTypeRequiredDescription
startTimeStringYesStart time, Unix millisecond timestamp, e.g. 1690196141868
endTimeStringNoEnd time, Unix millisecond timestamp, e.g. 1690196141868
Maximum interval between start time and end time is 90 days
idLessThanStringNoThe minOrderId returned from the previous query. Returns p2p order data less than the specified entry parameter.
limitStringNoNumber of queries, default 100
statusStringNoP2P order status
pending_pay: pending payment
Paid: coins to be released
Appeal: Appeal in progress
Completed: Completed
cancelled: cancelled
advNoStringYesAdvertisement order number
sideStringNoTX type
buy: Buy
sell: Sell
coinStringNoDigital currency name, e.g. USDT
languageStringYesLanguage
zh-CN: Chinese
en-US: English
fiatStringNoFiat currency name, e.g. USD
orderNoStringNoOrder no.
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1681201761390,
"data": {
"orderList": [
{
"orderId": "557",
"orderNo": "1029222647482966017",
"advNo": "1027001359783845889",
"price": "1",
"count": "11",
"side": "buy",
"fiat": "USD",
"coin": "USDT",
"withdrawTime": "",
"representTime": "",
"paymentTime": "",
"releaseTime": "",
"amount": "11",
"buyerRealName": "",
"sellerRealName": "兰州",
"status": "cancelled",
"paymentInfo": {
"paymethodName": "paypal",
"paymethodId": "3",
"paymethodInfo": [
{
"name": "繁体中文",
"required": "yes",
"type": "number",
"value": "11****"
},
{
"name": "繁体中文",
"required": "yes",
"type": "file",
"value": "http://qrc.bitgetapp.com/otc/images/20230116/498ab1b8-3ba6-44bd-9570-b3e5c118233f.jpg"
}
]
},
"ctime": "1681111722251"
}
],
"minOrderId": "557"
}
}

Response Parameter

ParameterTypeDescription
orderListArrayOrder number
> orderIdStringID
> orderNoStringOrder no.
> advNoStringAdvertisement order number
> sideStringTypes: buy/sell
> countStringAmount
> coinStringFiat Currency
> priceStringPrice
> fiatStringFiat
> withdrawTimeStringTime of withdrawal of this order
> representTimeStringAppeal time
> releaseTimeStringCoin release time
> paymentTimeStringRepayment time
> amountStringOrder amount
statusStringP2P order status
buyerRealNameStringBuyer name
sellerRealNameStringSeller name
cTimeStringCreation time, Unix millisecond timestamps
uTimeStringUpdate time, Unix millisecond timestamps
> paymentInfoObjectPayment Info
>> paymethodNameStringPayment method name
>> paymethodIdStringPayment method ID
>> paymethodInfoArrayPayment method details
>>> nameStringPayment detail name
>>> requiredStringRequired or not: yes/no
>>> typeStringtype, number/file. Ignore this parameter
>>> valueStringPayment information value
minOrderIdStringReturns the minimum orderId of record.