查询发布广告限额信息

查询发布 P2P 广告时的各类限额约束（价格、浮动比例、数量、单笔法币金额、付款时效、支持的支付方式），用于发布/更新广告前的参数校验。

HTTP请求

GET /api/v3/fiat/merchant/ads/limit

接口权限要求: P2P 账户读

请求参数

参数名	类型	必填	描述
coinId	string	是	数字货币 ID（如 USDT）
fiatUnit	string	是	法币类型（如 BRL）
side	string	是	交易方向：`BUY` / `SELL`

请求

GET /api/v3/fiat/merchant/ads/limit?coinId=USDT&fiatUnit=BRL&side=BUY

返回参数

参数	类型	说明
minPrice	string	【广告单价】发布固定价格广告时，单价允许的最小值
maxPrice	string	【广告单价】发布固定价格广告时，单价允许的最大值
minPriceRatio	string	【浮动定价】发布浮动价格广告时，浮动比例（`priceRatio`）允许的最小值
maxPriceRatio	string	【浮动定价】发布浮动价格广告时，浮动比例（`priceRatio`）允许的最大值
minQuantity	string	【广告总量/库存】整个广告可发布的加密货币总数量最小值（非单笔；按商家等级/类型区分）
maxQuantity	string	【广告总量/库存】整个广告可发布的加密货币总数量最大值（非单笔；按商家等级/类型区分）
minSingleTransAmount	string	【单笔交易】买家单次下单的法币金额最小值（对应发布广告的 `minSingleTransAmount`；按方向返回买/卖对应值）
maxSingleTransAmount	string	【单笔交易】买家单次下单的法币金额最大值（对应发布广告的 `maxSingleTransAmount`；按方向返回买/卖对应值）
maxPayTimeLimit	integer	【付款时效】买家下单后的付款时限允许的最大值（分钟）
payMethods	array	支持的支付方式类型列表（仅类型 id + 名称，不含账号）
payMethods[].id	long	支付方式类型 ID
payMethods[].name	string	支付方式名称

响应

{
  "msg": "success",
  "code": 0,
  "data": {
    "minPrice": "1",
    "maxPrice": "100",
    "minPriceRatio": "0.8",
    "maxPriceRatio": "1.2",
    "minQuantity": "100",
    "maxQuantity": "20000",
    "minSingleTransAmount": "50",
    "maxSingleTransAmount": "5000",
    "maxPayTimeLimit": 30,
    "payMethods": [
      { "id": 205, "name": "PIX" },
      { "id": 1, "name": "Bank Transfer" }
    ]
  }
}