获取广告详情
获取广告详情
描述
获取指定P2P广告的详细信息。
HTTP请求
- GET /api/v3/p2p/ad-info
- 限频规则: 10次/秒/UID
- 需要统一账户P2P只读权限
请求示例
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:zh-CN" \
-H "Content-Type: application/json"
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| advId | String | 是 | 广告ID |
返回示例
{
"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": "快速放币",
"tradeTerm": "",
"payMethodIds": [
{
"payMethodId": "1",
"userPayMethodId": "101"
}
],
"tokenPrecision": "2",
"fiatPrecision": "2",
"market": "public",
"avgTime": "5",
"createdTime": "1740000000000",
"updatedTime": "1740000001000"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| advId | String | 广告ID |
| side | String | 交易方向：buy 买入 sell 卖出 |
| priceType | String | 价格类型：fixed 固定价 floating 浮动价 |
| token | String | 数字货币 |
| fiat | String | 法币 |
| price | String | 广告价格 |
| amount | String | 广告数量 |
| minAmount | String | 单笔最小交易额 |
| maxAmount | String | 单笔最大交易额 |
| payDuration | String | 付款时限，单位为分钟 |
| soldAmount | String | 已售出数量 |
| lastAmount | String | 剩余数量 |
| premium | String | 溢价率 |
| turnover | String | 成交量 |
| remark | String | 广告备注 |
| tradeTerm | String | 交易条款 |
| payMethodIds | List | 支付方式ID数组 |
| >payMethodId | String | 支付方式ID |
| >userPayMethodId | String | 用户支付方式ID |
| tokenPrecision | String | 数字货币精度 |
| fiatPrecision | String | 法币精度 |
| market | String | 广告市场：public 公开 private 私有 |
| avgTime | String | 平均用时（出售为放币，购买为付款） |
| createdTime | String | 广告创建时间 |
| updatedTime | String | 广告更新时间 |