获取p2p商家广告单列表

限速规则 10次/1s (UID)

描述

获取p2p商家广告单列表

HTTP请求

• GET /api/v2/p2p/advList

请求示例

curl "https://api.bitget.com/api/v2/p2p/advList?online=yes&limit=20" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
startTime	String	是	查询开始时间 (仅限查询90天内数据)
endTime	String	否	查询结束时间
idLessThan	String	否	上一次查询返回的minMerchantId， 返回ID小于该入参的数据
limit	String	否	查询条数 默认值为100
status	String	否	广告单状态 上架中online 下架中offline 已完成completed 编辑中editing
advNo	String	否	广告单号
side	String	否	buy/sell
coin	String	否	币种，如USDT
language	String	否	zh-CN/en-US
fiat	String	否	法币
orderBy	String	否	排序字段(desc)：createTime/price 默认createTime
payMethodId	String	否	支付方式id
sourceType	String	否	查询范围 owner:查询自己的广告单 competitior:查询其他商家的广告单 ownerAndCompetitior:查询所有广告单

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1681195810516,
    "data": {
        "merchantList": [
            {
                "registerTime": "1678674575000",
                "coinPrecision": "2",
                "price": "1.01",
                "advId": "3784051421",
                "advNo": "23423423424234",
                "side": "buy",
                "advSize": "12432",
                "size": "123",
                "coin": "USDT",
                "fiat": "USD",
                "fiatPrecision": "2",
                "fiatSymbol": "US Dollars",
                "status": "online",
                "maxTradeAmount": "最大下单金额",
                "minTradeAmount": "最小下单金额",
                "payDuration": "5",
                "turnoverNum": "1",
                "turnoverRate": "1。00",
                "label": "online",
                "hide": "no",
                "userLimitList":[
                    {
                      "minCompleteNum": "0",
                      "maxCompleteNum": "0",
                      "placeOrderNum": "0",
                      "allowMerchantPlace": "no",
                      "thirtyCompleteRate": "0",
                      "country": ""
                    }
                ],
                "paymentMethod": [
                  {
                    "paymentMethod": "",
                    "paymentId": "3",
                    "paymentInfo": [
                      {
                        "name": "",
                        "required": true,
                        "type": "number"
                      },
                      {
                        "name": "",
                        "required": true,
                        "type": "file"
                      }
                    ]
                  }
                ],
                "ctime": "1677029278156",
                "utime": "1677029278156",
                "merchantCertifiedList":[
                    {
                        "imageUrl":"https://www.google.com",
                        "desc":"gold"
                    }
                ]
            }
        ],
        "minAdvId": "594"
    }
}

返回值说明

返回字段	字段说明
advList	查询响应array
> advId	ID
> advNo	广告单号
> side	买/卖类型：sell/buy
> advSize	广告单总数量
> size	已成交数量
> coin	币(BGB,USDT,BTC,ETH)
> price	价格(USD, JPY, CNY)
> coinPrecision	币的小数位
> fiat	法币名称
> fiatPrecision	法币小数位
> fiatSymbol	法币符号
> status	状态
> hide	广告单是否隐藏: yes/no
> maxTradeAmount	最大下单数量
> minTradeAmount	最小下单数量
> payDuration	下单后支付时间期限, min
> turnoverNum	商户 成单总数
> turnoverRate	成交率
> remark	备注
> ctime	创建时间, ms
> utime	最新修改时间, ms
> userLimitList	广告单限制Array:以下规则用户禁止下单
>> minCompleteNum	用户完成下单最小数量
>> maxCompleteNum	用户完成下单最大数量
>> placeOrderNum	用户在此广告单下最多可以下多少单
>> allowMerchantPlace	是否允许商家下单
>> thirtyCompleteRate	30日成交率
> paymentMethod	支付方式Array
>> paymentMethod	支付名称
>> paymentId	支付ID
>> paymentInfo	支付方式详情信息
>>> required	是否必须: true/false
>>> name	支付详细说明
>>> type	支付方式详情信息类型
> merchantCertifiedResult	商家认证
>> imageUrl	金牌商家认证图片
>> desc	金牌商家认证描述
minAdvId	返回结果的最小advId