获取我的广告列表

描述

获取当前商家账号发布的广告列表，支持按状态、时间范围、币种筛选以及游标分页。

HTTP请求

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

请求示例

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

请求参数

参数名	参数类型	是否必须	描述
startTime	String	否	开始时间戳，Unix时间戳的毫秒数格式，如 1597026383085。最大查询范围90天，单次查询范围不超过30天
endTime	String	否	结束时间戳，Unix时间戳的毫秒数格式，如 1597026383085
limit	String	否	每页条目数，默认 10
cursor	String	否	游标ID，用于翻页。首次调用不传，后续调用传上次返回的 nextId
advId	String	否	广告ID
token	String	否	加密货币币种
fiat	String	否	法币币种
status	String	否	广告状态： publish 已上架 delist 已下架 remove 已删除。不传则默认返回全部状态

返回示例

{
  "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"
  }
}

返回参数

返回字段	参数类型	字段说明
items	List	数据集合
>advId	String	广告ID
>side	String	交易方向： buy 买入 sell 卖出
>priceType	String	价格类型： fixed 固定价 floating 浮动价
>token	String	数字货币
>fiat	String	法币
>price	String	广告价格
>soldAmount	String	已售出数量
>lastAmount	String	剩余数量
>payMethods	List	支付方式数组
>>payMethodId	String	支付方式ID
>status	String	广告状态： publish 已上架 delist 已下架 remove 已删除
>createdTime	String	广告创建时间
>updatedTime	String	广告更新时间
nextId	String	下一页标识ID