Skip to main content

Get Merchant Advertisement List

Frequency limit:10 times/1s (UID)

Description

Get Merchant Advertisement List

HTTP request

  • GET /api/v2/p2p/advList
Request Example
curl "https://api.bitget.com/api/v2/p2p/advList?startTime=1659403328000&endTime=1659410528000&limit=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 minAdvId returned from the previous query. Returns the data whose advId is less than the specified input parameter.
limitStringNoNumber of queries: Default: 100.
statusStringNoAdvertisement order status
online: Uploaded
offline: Offline
editing: Editing
completed: Completed
advNoStringNoAdvertisement order
sideStringNoTX type
buy: Buy
sell: Sell
coinStringNoDigital currency
languageStringNoLanguage
zh-CN: Chinese
en-US: English
fiatStringNoFiat
orderByStringNoSort Fields
createTime: Create time
price: Price
Descending, by createTime by default
payMethodIdStringNoPayment method id
sourceTypeStringNoQuery range
owner:query owner advertisement
competitior:query other merchant advertisement
ownerAndCompetitior:query all advertisement
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1681195810516,
"data": {
"merchantList": [
{
"registerTime": "1678674575000",
"coinPrecision": "2",
"price": "1.01",
"advId": "3784051421",
"advNo": "23423423424234",
"side": "buy",
"advSize": "12432",
"size": "123",
"coin": "USDT",
"fiat": "USD",
"fiatPrecision": "2",
"fiatSymbol": "US Dollars",
"status": "online",
"maxTradeAmount": "最大下单金额",
"minTradeAmount": "最小下单金额",
"payDuration": "5",
"turnoverNum": "1",
"turnoverRate": "1。00",
"label": "online",
"hide": "no",
"userLimitList":[
{
"minCompleteNum": "0",
"maxCompleteNum": "0",
"placeOrderNum": "0",
"allowMerchantPlace": "no",
"thirtyCompleteRate": "0",
"country": ""
}
],
"paymentMethod": [
{
"paymentMethod": "",
"paymentId": "3",
"paymentInfo": [
{
"name": "",
"required": true,
"type": "number"
},
{
"name": "",
"required": true,
"type": "file"
}
]
}
],
"ctime": "1677029278156",
"utime": "1677029278156",
"merchantCertifiedList":[
{
"imageUrl":"https://www.google.com",
"desc":"gold"
}
]
}
],
"minAdvId": "594"
}
}

Response Parameter

ParameterTypeDescription
advListArrayNumber of advertisement orders
> advNoStringAdvertisement order number
> advIdStringAdvertisement order ID
> sideStringTX type
sell
buy
> advSizeStringTotal number of advertisement orders
> sizeStringFilled quantity
> coinStringCoins such as BGB, USDT, BTC, ETH etc.
> priceStringPrice
> coinPrecisionStringCurrency precision, decimala
> fiatStringFiat
> fiatPrecisionStringFiat decimals
> fiatSymbolStringCurrency symbol
> statusStringAdvertisement order status
online: Uploaded
offline: Offline
editing: Editing
completed: Completed
> hideStringHide the advertisement order or not
yes: Hide
no: not hide
> maxTradeAmountStringMaximum order quantity
> minTradeAmountStringMinimum order quantity
> payDurationStringTime period for payment after placing an order, min
> turnoverNumStringTotal trading amount
> turnoverRateStringClose rate
> labelStringNote
> cTimeStringCreation time, Unix millisecond timestamps
> uTimeStringUpdate time, Unix millisecond timestamps
> userLimitListArrayUpper limit of the advertiser order restricted user
>> minCompleteNumStringMinimum number of completed user orders
>> maxCompleteNumStringMaximum number of completed user orders
>> placeOrderNumStringMaximum number of orders a user can place under this advertisement
>> allowMerchantPlaceStringWhether to allow merchants to place orders
yes: allow
no: not allow
>> completeRate30dString30-day close rate
>> countryStringOnly people from these countries are allowed to place orders
> paymentMethodListArrayPayment methods number
>> paymentMethodStringPayment name
>> paymentIdStringPayment ID
>> paymentInfoArrayPayment method detail information
>>> requiredStringRequired or not: true/false
>>> nameStringPayment details
>>> typeStringPayment method detail information type
> merchantCertifiedResultArrayMerchant authentication number
>> imageUrlStringGold Merchant certification pictures
>> descStringGold Merchant certification parameter description
minAdvIdStringReturns the minimum advId of the result