Get Ad List
Get Ad List
Description
Get the list of public P2P advertisements. Only ads in the published (on-shelf) status are returned.
HTTP Request
- GET /api/v3/p2p/ad-list
- Rate limit: 10/sec/UID
- Permission: UTA P2P (read)
Request
curl "https://api.bitget.com/api/v3/p2p/ad-list?token=USDT&fiat=CNY&side=buy" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"
Request Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| token | String | Yes | Cryptocurrency, e.g. USDT, USDC |
| fiat | String | Yes | Fiat currency, e.g. CNY, USD |
| side | String | Yes | Trade direction: buy buy sell sell |
| amount | String | No | Trade amount in fiat currency, used to filter eligible ads |
| pageNum | String | No | Page number |
| limit | String | No | Number of items per page. Maximum: 10 |
Response
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": [
{
"advId": "1234567890",
"merchantId": "9876543210",
"merchantName": "MerchantA",
"token": "USDT",
"fiat": "CNY",
"side": "buy",
"price": "7.28",
"minAmount": "100",
"maxAmount": "10000",
"quantity": "500",
"payMethods": [
{
"payMethodId": "1",
"payMethodName": "Alipay"
}
],
"completedOrderNum": "1200",
"completedRate": "0.99",
"avgReleaseTime": "5",
"createdTime": "1740000000000"
}
]
}
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| advId | String | Ad ID |
| merchantId | String | Merchant ID |
| merchantName | String | Merchant name |
| token | String | Cryptocurrency |
| fiat | String | Fiat currency |
| side | String | Trade direction: buy buy sell sell |
| price | String | Ad price in fiat currency |
| minAmount | String | Minimum trade amount per order in fiat currency |
| maxAmount | String | Maximum trade amount per order in fiat currency |
| quantity | String | Remaining tradable quantity in cryptocurrency |
| payMethods | List | Supported payment methods |
| >payMethodId | String | Payment method ID |
| >payMethodName | String | Payment method name |
| completedOrderNum | String | Total completed orders |
| completedRate | String | Historical completion rate |
| avgReleaseTime | String | Average coin release time in minutes |
| createdTime | String | Ad creation time (ms timestamp) |