Change Advertisement Price

Dedicated price-change endpoint that supports fixed and floating pricing. The server calculates the final floating price from the real-time reference price.

HTTP Request

POST /api/v3/fiat/merchant/ads/price
Note: The request body must be in JSON format. This endpoint is an exception to the standard rule that request parameters must be passed via the URL query string.

Required Permission: P2P Deal Ad

Request Parameters

Name	Type	Mandatory	Description
advNo	string	yes	Advertisement unique identifier
priceType	integer	no	Pricing type: `0` = fixed price (default); `1` = floating price. Omit this parameter for fixed pricing.
price	BigDecimal	conditional	Target unit price for a fixed-price advertisement. Required and must be greater than 0 when `priceType` is omitted or equals `0`. Not used in the floating-price calculation when `priceType` = `1`.
priceRatio	BigDecimal	conditional	Target floating ratio for a floating-price advertisement. Required and must be greater than or equal to 0 only when `priceType` = `1`. Not used for fixed-price calculation. The server calculates the final price from the real-time reference price multiplied by this ratio, and rounds down to the fiat-currency precision.

Request (Fixed Price, priceType defaults to 0)

{
  "advNo": "a1375750128856004608",
  "price": 234
}

Request (Floating Price)

{
  "advNo": "a1375750128856004608",
  "priceType": 1,
  "priceRatio": 0.05
}

Response Parameters

Name	Type	Description
code	integer	0 indicates success
msg	string	Result description
data	null	No data returned

Response

{
  "code": 0,
  "msg": "success",
  "data": null
}