Get My Ads
Get My Ads
Description
Get the list of advertisements created by the current merchant account, with support for filtering by status, time range, currency, and pagination via cursor.
HTTP Request
- GET /api/v3/p2p/my-ads
- Rate limit: 10/sec/UID
- Permission: UTA P2P (read)
Request
curl "https://api.bitget.com/api/v3/p2p/my-ads?limit=10" \
-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 |
|---|---|---|---|
| startTime | String | No | Start time. Unix timestamp in milliseconds, e.g. 1597026383085. Maximum query range: 90 days; single query range: 30 days |
| endTime | String | No | End time. Unix timestamp in milliseconds, e.g. 1597026383085 |
| limit | String | No | Number of items per page. Default: 10 |
| cursor | String | No | Cursor ID for pagination. Leave empty for the first request; pass the nextId returned in the previous response for subsequent requests |
| advId | String | No | Ad ID |
| token | String | No | Cryptocurrency |
| fiat | String | No | Fiat currency |
| status | String | No | Ad status: publish on-shelf delist off-shelf remove removed. Returns all statuses if not provided |
Response
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"items": [
{
"advId": "1234567890",
"side": "sell",
"priceType": "fixed",
"token": "USDT",
"fiat": "CNY",
"price": "7.28",
"soldAmount": "300",
"lastAmount": "700",
"payMethods": [
{
"payMethodId": "1"
}
],
"status": "publish",
"createdTime": "1740000000000",
"updatedTime": "1740000001000"
}
],
"nextId": "1234567889"
}
}
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| items | List | Data list |
| >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 |
| >soldAmount | String | Sold quantity |
| >lastAmount | String | Remaining quantity |
| >payMethods | List | Payment method array |
| >>payMethodId | String | Payment method ID |
| >status | String | Ad status: publish on-shelf delist off-shelf remove removed |
| >createdTime | String | Ad creation time |
| >updatedTime | String | Ad last update time |
| nextId | String | Next page cursor ID |