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:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"
Request Parameter
Parameter | Type | Required | Description |
---|---|---|---|
startTime | String | Yes | Start time, Unix millisecond timestamp, e.g. 1690196141868 |
endTime | String | No | End time, Unix millisecond timestamp, e.g. 1690196141868 Maximum interval between start time and end time is 90 days |
idLessThan | String | No | The minAdvId returned from the previous query. Returns the data whose advId is less than the specified input parameter. |
limit | String | No | Number of queries: Default: 20, max:20. |
status | String | Yes | Advertisement order statusonline : Onlineoffline : Offlineediting : Editingcompleted : Completed |
advNo | String | No | Advertisement order |
side | String | Yes | TX type buy: Buy sell: Sell |
coin | String | Yes | Digital currency |
language | String | No | Language zh-CN: Chinese en-US: English |
fiat | String | Yes | Fiat |
orderBy | String | No | Sort Fields createTime: Create time price: Price Descending, by createTime by default |
payMethodId | String | No | Payment method id |
sourceType | String | No | Query range owner:query owner advertisement(default) competitior:query other merchant advertisement ownerAndCompetitior:query all advertisement |
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1696930053072,
"data": {
"advList": [
{
"advId": "1",
"advNo": "1",
"side": "buy",
"advSize": "0.6",
"size": "0",
"coin": "BTC",
"price": "155570.9",
"coinPrecision": "36",
"fiat": "CNY",
"fiatPrecision": "2",
"fiatSymbol": "¥",
"status": "online",
"hide": "no",
"maxTradeAmount": "93342.54",
"minTradeAmount": "100",
"payDuration": "4",
"turnoverNum": "8",
"turnoverRate": "1.00",
"label": null,
"userLimitList": {
"minCompleteNum": "0",
"maxCompleteNum": "0",
"placeOrderNum": "0",
"allowMerchantPlace": "no",
"completeRate30d": "0",
"country": ""
},
"paymentMethodList": [
{
"paymentMethod": "Bank Card",
"paymentId": "11",
"paymentInfo": [
{
"name": "Bank Card",
"required": true,
"type": "txt"
}
]
},
{
"paymentMethod": "WeChat",
"paymentId": "12",
"paymentInfo": [
{
"name": "Payment code",
"required": true,
"type": "file"
},
{
"name": "WeChatAccount",
"required": true,
"type": "txt"
}
]
},
{
"paymentMethod": "Alipay",
"paymentId": "13",
"paymentInfo": [
{
"name": "AlipayAccount",
"required": true,
"type": "txt"
},
{
"name": "Payment code",
"required": true,
"type": "file"
}
]
}
],
"merchantCertifiedList": [],
"utime": "1696733724267",
"ctime": "1696733724267"
}
],
"minAdvId": "1"
}
}
Response Parameter
Parameter | Type | Description |
---|---|---|
advList | Array | Number of advertisement orders |
> advId | String | Advertisement order ID |
> advNo | String | Advertisement order number |
> side | String | TX type sell buy |
> advSize | String | Total number of advertisement orders |
> size | String | Filled quantity |
> coin | String | Coins such as BGB, USDT, BTC, ETH etc. |
> price | String | Price |
> coinPrecision | String | Currency precision, decimala |
> fiat | String | Fiat |
> fiatPrecision | String | Fiat decimals |
> fiatSymbol | String | Currency symbol |
> status | String | Advertisement order statusonline : Onlineoffline : Offlineediting : Editingcompleted : Completed |
> hide | String | Hide the advertisement order or not yes: Hide no: not hide |
> maxTradeAmount | String | Maximum order quantity |
> minTradeAmount | String | Minimum order quantity |
> payDuration | String | Time period for payment after placing an order, min |
> turnoverNum | String | Total trading amount |
> turnoverRate | String | Close rate |
> label | String | Note |
> cTime | String | Creation time, Unix millisecond timestamps |
> uTime | String | Update time, Unix millisecond timestamps |
> userLimitList | Array | Upper limit of the advertiser order restricted user |
>> minCompleteNum | String | Minimum number of completed user orders |
>> maxCompleteNum | String | Maximum number of completed user orders |
>> placeOrderNum | String | Maximum number of orders a user can place under this advertisement |
>> allowMerchantPlace | String | Whether to allow merchants to place orders yes: allow no: not allow |
>> completeRate30d | String | 30-day close rate |
>> country | String | Only people from these countries are allowed to place orders |
> paymentMethodList | Array | Payment methods number |
>> paymentMethod | String | Payment name |
>> paymentId | String | Payment ID |
>> paymentInfo | Array | Payment method detail information |
>>> required | Boolean | Required or not: true/false |
>>> name | String | Payment details |
>>> type | String | Payment method detail information type |
> merchantCertifiedResult | Array | Merchant authentication number |
>> imageUrl | String | Gold Merchant certification pictures |
>> desc | String | Gold Merchant certification parameter description |
minAdvId | String | Returns the minimum advId of the result |