获取广告市场列表

分页获取所有商家的广告列表（市场大盘）

HTTP请求

• GET /api/v3/fiat/market/ads/pagination

接口权限要求: P2P 账户读

限速规则: 50次/秒

请求参数

参数名	类型	必填	描述
fiatUnit	string	是	法币类型（如 USD, EUR 等）
countryCode	string	否	国家代码（如 US, CN 等）
side	string	否	交易方向：BUY / SELL
amount	BigDecimal	否	金额筛选条件
quantity	BigDecimal	否	数量筛选条件
coinId	string	是	交易币种 ID（如 BTC, ETH 等）
payMethod	string	否	支付方式，逗号分隔的 id 字符串
allowTrade	boolean	否	筛选仅可交易的广告
haveTrade	boolean	否	是否筛选已交易过的广告
follow	boolean	否	是否筛选关注的商家
page	integer	否	当前页码，默认为 1

返回参数

参数	类型	说明
advNo	string	广告编号
price	BigDecimal	广告价格
availableQuantity	BigDecimal	可用数量
coinName	string	币种名称
countryCode	string	国家代码
fiatUnit	string	法币单位
side	string	交易方向：BUY / SELL
payMethod	string	支付方式 ID
payTimeLimit	integer	付款时限（分钟）
autoReplyMsg	string	自动回复消息
tradeTerms	string	交易条款
minSingleTransAmount	BigDecimal	单笔最小金额
maxSingleTransAmount	BigDecimal	单笔最大金额
kycLevel	string	KYC 等级：NONE / PRIMARY / ADVANCED
userAllTradeCountMin	integer	最少完成交易次数要求
userAllTradeCountMax	integer	最多交易次数限制
maxPayLimit	integer	广告最大下单次数
orderPayCount	integer	当前广告已下单次数
buyerRegDaysLimit	integer	买家注册天数要求
tags	string	广告标签
updateTime	long	更新时间（毫秒时间戳）
merchant	object	商家信息
merchant.nickName	string	商家昵称
merchant.memberId	string	商家会员 ID
merchant.registry	long	注册时间（毫秒时间戳）
merchant.vipLevel	integer	VIP 等级
merchant.emailAuthentication	boolean	是否邮箱认证
merchant.smsAuthentication	boolean	是否短信认证
merchant.identityVerification	boolean	是否身份认证
merchant.lastOnlineTime	long	最后在线时间（毫秒时间戳）
merchant.badge	string	商家徽章
merchant.merchantType	string	商家类型
merchantStatistics	object	商家交易统计
merchantStatistics.totalBuyCount	integer	总买单数
merchantStatistics.totalSellCount	integer	总卖单数
merchantStatistics.doneLastMonthCount	integer	近 30 天完成订单数
merchantStatistics.avgBuyHandleTime	number	平均买单处理时间（分钟）
merchantStatistics.avgSellHandleTime	number	平均卖单处理时间（分钟）
merchantStatistics.lastMonthCompleteRate	string	近 30 天完成率
merchantStatistics.completeRate	string	总完成率
merchantStatistics.avgHandleTime	number	平均处理时间（分钟）

响应

{
  "msg": "success",
  "code": 0,
  "data": [
    {
      "advNo": "a1369623409544374272",
      "price": 70,
      "availableQuantity": 8,
      "coinName": "USDT",
      "countryCode": "GB",
      "updateTime": 1737426724000,
      "fiatUnit": "RUB",
      "side": "SELL",
      "payMethod": "1",
      "merchant": {
        "nickName": "davis_user",
        "imId": "aa86298cff0066b8a294e0e1ea1a4ae7",
        "memberId": "3f903efe008c45d694f80951016fc7b9",
        "registry": 1731831707000,
        "vipLevel": 0,
        "greenDiamond": false,
        "emailAuthentication": true,
        "smsAuthentication": true,
        "identityVerification": true,
        "lastOnlineTime": 1737873561151,
        "badge": "0",
        "merchantType": "normal"
      },
      "merchantStatistics": {
        "totalBuyCount": 0,
        "totalSellCount": 2,
        "doneLastMonthCount": 1,
        "avgBuyHandleTime": 0,
        "avgSellHandleTime": 0,
        "lastMonthCompleteRate": "0.3333",
        "completeRate": "0.5000",
        "avgHandleTime": 0
      },
      "payTimeLimit": 15,
      "autoReplyMsg": "",
      "tradeTerms": "",
      "minSingleTransAmount": 1,
      "maxSingleTransAmount": 700,
      "kycLevel": "PRIMARY",
      "requireMobile": false,
      "userAllTradeCountMax": 0,
      "userAllTradeCountMin": 0,
      "maxPayLimit": 0,
      "orderPayCount": 0,
      "buyerRegDaysLimit": 0,
      "tags": ""
    }
  ],
  "page": {
    "total": 3,
    "currPage": 1,
    "pageSize": 10,
    "totalPage": 1
  }
}