Create/Update Ad
Create a new ad or update an existing ad.
HTTP Request
- POST
/api/v3/fiat/merchant/ads/save_or_update
Required Permission: P2P Deal Ad
Request Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| advNo | string | no | Ad unique identifier (required when updating) |
| payTimeLimit | integer | yes | Payment time limit (minutes) |
| initQuantity | BigDecimal | yes | Initial tradable quantity |
| supplyQuantity | BigDecimal | no | Additional quantity to supply when updating |
| price | BigDecimal | yes | Price per unit |
| coinId | string | yes | Crypto coin ID (e.g., BTC, ETH) |
| countryCode | string | no | Country code |
| side | string | yes | Trade direction: BUY / SELL |
| advStatus | string | no | If provided during update, also updates ad status. See enum values |
| fiatUnit | string | yes | Fiat currency type (e.g., USD, EUR) |
| payMethod | string | yes | User payment account ID(s), comma-separated |
| autoReplyMsg | string | no | Auto-reply message |
| tradeTerms | string | no | Trade terms |
| minSingleTransAmount | BigDecimal | yes | Minimum single trade amount |
| maxSingleTransAmount | BigDecimal | yes | Maximum single trade amount |
| kycLevel | string | no | Required KYC level for counterparty |
| userAllTradeCountMin | integer | yes | Minimum completed trades required |
| userAllTradeCountMax | integer | yes | Maximum trades limit |
| maxPayLimit | integer | no | Max orders per user on this ad |
| buyerRegDaysLimit | integer | no | Minimum buyer registration days |
Response Parameters
| Name | Type | Description |
|---|---|---|
| code | integer | 0 indicates success |
| msg | string | Result description |
| data | string | Ad number (advNo) |
Response
{
"code": 0,
"msg": "success",
"data": "a1375750128856004608"
}