Get Ad Info
Get Ad Info
Description
Get detailed information for a specific P2P advertisement.
HTTP Request
- GET /api/v3/p2p/ad-info
- Rate limit: 10/sec/UID
- Permission: UTA P2P (read)
Request
curl "https://api.bitget.com/api/v3/p2p/ad-info?advId=1234567890" \
-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 |
|---|---|---|---|
| advId | String | Yes | Ad ID |
Response
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"advId": "1234567890",
"side": "sell",
"priceType": "fixed",
"token": "USDT",
"fiat": "CNY",
"price": "7.28",
"amount": "1000",
"minAmount": "100",
"maxAmount": "10000",
"payDuration": "15",
"soldAmount": "300",
"lastAmount": "700",
"premium": "",
"turnover": "2184",
"remark": "Fast release",
"tradeTerm": "",
"payMethodIds": [
{
"payMethodId": "1",
"userPayMethodId": "101"
}
],
"tokenPrecision": "2",
"fiatPrecision": "2",
"market": "public",
"avgTime": "5",
"createdTime": "1740000000000",
"updatedTime": "1740000001000"
}
}
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| advId | String | Ad ID |
| side | String | Trade direction: buy buy sell sell |
| priceType | String | Price type: fixed fixed price floating floating price |
| token | String | Cryptocurrency |
| fiat | String | Fiat currency |
| price | String | Ad price |
| amount | String | Ad quantity |
| minAmount | String | Minimum trade amount per order |
| maxAmount | String | Maximum trade amount per order |
| payDuration | String | Payment time limit in minutes |
| soldAmount | String | Sold quantity |
| lastAmount | String | Remaining quantity |
| premium | String | Premium rate |
| turnover | String | Turnover |
| remark | String | Ad remarks |
| tradeTerm | String | Trade terms |
| payMethodIds | List | Payment method ID array |
| >payMethodId | String | Payment method ID |
| >userPayMethodId | String | User payment method ID |
| tokenPrecision | String | Cryptocurrency decimal precision |
| fiatPrecision | String | Fiat currency decimal precision |
| market | String | Ad market: public public private private |
| avgTime | String | Average processing time (release time for sell / payment time for buy) |
| createdTime | String | Ad creation time |
| updatedTime | String | Ad last update time |