获取我的广告列表

分页获取当前商家的广告列表

HTTP请求

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

接口权限要求: P2P 账户读

限速规则: 50次/秒

请求参数

参数名	类型	必填	描述
advNo	string	否	广告订单的唯一标识
merchantId	string	否	商户 ID
coinId	string	否	交易的币种 ID（如 BTC, ETH 等）
fiatUnit	string	否	法币类型（如 USD, EUR 等）
side	string	否	交易方向：BUY / SELL
advStatus	string	否	订单状态，多个状态用逗号分隔，详见枚举值，传英文名
kycLevel	string	否	KYC（身份验证）级别，参见枚举
startTime	long	否	查询开始时间（时间戳）
endTime	long	否	查询结束时间（时间戳）
page	integer	否	当前页码，默认为 1
limit	integer	否	每页显示的记录数，最大为 10

返回参数

参数	类型	说明
advNo	string	广告编号
side	string	交易方向：BUY / SELL
advStatus	string	广告状态：OPEN / CLOSE / LOW_STOCK
price	BigDecimal	广告价格
quantity	BigDecimal	总数量
initAmount	BigDecimal	初始金额
availableQuantity	BigDecimal	可用数量
frozenQuantity	BigDecimal	冻结数量
coinId	string	币种 ID
coinName	string	币种名称
fiatUnit	string	法币单位
countryCode	string	国家代码
feeType	string	手续费类型：NONE / EACH_FIX / EACH_RATIO
commissionRate	BigDecimal	佣金比例
payTimeLimit	integer	付款时限（分钟）
payMethod	string	支付方式 ID
paymentInfo	array	支付方式详细信息
paymentInfo[].id	integer	用户收款账号ID
paymentInfo[].payMethod	integer	支付方式类型
paymentInfo[].account	string	账号
paymentInfo[].payee	string	收款人
paymentInfo[].extend	string	扩展信息（JSON 字符串）
minSingleTransAmount	BigDecimal	单笔最小金额
maxSingleTransAmount	BigDecimal	单笔最大金额
kycLevel	string	KYC 等级：NONE / PRIMARY / ADVANCED
requireMobile	boolean	是否要求绑定手机
autoReplyMsg	string	自动回复消息
tradeTerms	string	交易条款
userAllTradeCountMin	integer	最少完成交易次数要求
userAllTradeCountMax	integer	最多交易次数限制
maxPayLimit	integer	广告最大下单次数
buyerRegDaysLimit	integer	买家注册天数要求
exchangeCount	integer	交易次数
orderPayCount	integer	当前广告已下单次数
makerInstitutionName	string	商户机构名称
onlyTradeKybUser	boolean	是否仅限 KYB 用户交易
paymethodIds	string	支付方式 ID 列表
securityOrderPaymethodIds	string	安全订单支付方式 ID 列表
createTime	long	创建时间（毫秒时间戳）
updateTime	long	更新时间（毫秒时间戳）

响应

{
  "msg": "success",
  "code": 0,
  "data": [
    {
      "advNo": "a1740449468605790209",
      "payTimeLimit": 15,
      "quantity": 10.0,
      "price": 11.0,
      "initAmount": 110.0,
      "frozenQuantity": 0.0,
      "availableQuantity": 10.0,
      "coinId": "5989b56ba96a43599dbeeca5bb053f43",
      "coinName": "USDT",
      "countryCode": "GB",
      "commissionRate": 0.0,
      "advStatus": "CLOSE",
      "side": "SELL",
      "createTime": 1780422986000,
      "updateTime": 1780423171000,
      "fiatUnit": "GBP",
      "feeType": "NONE",
      "autoReplyMsg": "",
      "tradeTerms": "",
      "payMethod": "1",
      "paymentInfo": [
        {
          "id": 1605,
          "payMethod": 1,
          "account": "123",
          "extend": "{\"accountType\":\"123\",\"typeOfBank\":\"123\"}"
        }
      ],
      "minSingleTransAmount": 1.0,
      "maxSingleTransAmount": 110.0,
      "kycLevel": "PRIMARY",
      "requireMobile": false,
      "userAllTradeCountMin": 0,
      "userAllTradeCountMax": 0,
      "maxPayLimit": 0,
      "buyerRegDaysLimit": 0,
      "exchangeCount": 0,
      "blockTrade": false,
      "orderPayCount": 0,
      "makerInstitutionName": "DAVIS0406C",
      "onlyTradeKybUser": true,
      "paymethodIds": "",
      "securityOrderPaymethodIds": ""
    }
  ],
  "page": {
    "total": 7,
    "currPage": 1,
    "pageSize": 10,
    "totalPage": 1
  }
}