获取公开广告列表

描述

获取P2P公开广告列表，仅返回上架状态的广告。

HTTP请求

• GET /api/v3/p2p/ad-list
• 限频规则: 10次/秒/UID
• 需要统一账户P2P只读权限

请求示例

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:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
token	String	是	加密货币，如 USDT、USDC
fiat	String	是	法币，如 CNY、USD
side	String	是	交易方向： buy 买入 sell 卖出
amount	String	否	交易金额，单位为法币，用于过滤可接单广告
pageNum	String	否	页码
limit	String	否	每页条数，最大 10

返回示例

{
  "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": "支付宝"
        }
      ],
      "completedOrderNum": "1200",
      "completedRate": "0.99",
      "avgReleaseTime": "5",
      "createdTime": "1740000000000"
    }
  ]
}

返回参数

返回字段	参数类型	字段说明
advId	String	广告ID
merchantId	String	广告商编号
merchantName	String	广告商名称
token	String	加密货币币种
fiat	String	法币币种
side	String	交易方向： buy 买入 sell 卖出
price	String	广告价格，单位为法币
minAmount	String	单笔最小交易额，单位为法币
maxAmount	String	单笔最大交易额，单位为法币
quantity	String	剩余可交易数量，单位为加密货币
payMethods	List	支持的支付方式列表
>payMethodId	String	支付方式ID
>payMethodName	String	支付方式名称
completedOrderNum	String	累计完成订单数
completedRate	String	历史成交率
avgReleaseTime	String	平均放币时长，单位为分钟
createdTime	String	广告创建时间（ms时间戳）