获取p2p商家广告单列表

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

描述

获取p2p商家广告单列表

HTTP请求

• GET /api/v2/p2p/advList

请求示例

curl "https://api.bitget.com/api/v2/p2p/advList?startTime=1659403328000&endTime=1659410528000&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	否	查询条数 默认值为20 ，最大值为20
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": 1696930053072,
    "data": {
        "advList": [
            {
                "advId": "1",
                "advNo": "1",
                "side": "buy",
                "advSize": "0.6",
                "size": "0",
                "coin": "BTC",
                "price": "155570.9",
                "coinPrecision": "36",
                "fiat": "CNY",
                "fiatPrecision": "2",
                "fiatSymbol": "￥",
                "status": "online",
                "hide": "no",
                "maxTradeAmount": "93342.54",
                "minTradeAmount": "100",
                "payDuration": "4",
                "turnoverNum": "8",
                "turnoverRate": "1.00",
                "label": null,
                "userLimitList": {
                    "minCompleteNum": "0",
                    "maxCompleteNum": "0",
                    "placeOrderNum": "0",
                    "allowMerchantPlace": "no",
                    "completeRate30d": "0",
                    "country": ""
                },
                "paymentMethodList": [
                    {
                        "paymentMethod": "Bank Card",
                        "paymentId": "11",
                        "paymentInfo": [
                            {
                                "name": "Bank Card",
                                "required": true,
                                "type": "txt"
                            }
                        ]
                    },
                    {
                        "paymentMethod": "WeChat",
                        "paymentId": "12",
                        "paymentInfo": [
                            {
                                "name": "Payment code",
                                "required": true,
                                "type": "file"
                            },
                            {
                                "name": "WeChatAccount",
                                "required": true,
                                "type": "txt"
                            }
                        ]
                    },
                    {
                        "paymentMethod": "Alipay",
                        "paymentId": "13",
                        "paymentInfo": [
                            {
                                "name": "AlipayAccount",
                                "required": true,
                                "type": "txt"
                            },
                            {
                                "name": "Payment code",
                                "required": true,
                                "type": "file"
                            }
                        ]
                    }
                ],
                "merchantCertifiedList": [],
                "utime": "1696733724267",
                "ctime": "1696733724267"
            }
        ],
        "minAdvId": "1"
    }
}

返回参数

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