Create Ad

Description

Create a new P2P advertisement. Merchants can set fixed or floating price, payment methods, quantity limits, and trader requirements.

HTTP Request

• POST /api/v3/p2p/ad-create
• Rate limit: 10/sec/UID
• Permission: UTA P2P (read and write)

Request

curl -X POST "https://api.bitget.com/api/v3/p2p/ad-create" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "USDT",
    "fiat": "CNY",
    "side": "sell",
    "priceType": "fixed",
    "price": "7.28",
    "minAmount": "100",
    "maxAmount": "10000",
    "quantity": "500",
    "payMethodIds": [{"payMethodId": "1", "userPayMethodId": "101"}],
    "payTimeLimit": "15"
  }'

Request Parameters

Parameters	Type	Required	Description
token	String	Yes	Cryptocurrency, e.g. USDT
fiat	String	Yes	Fiat currency, e.g. CNY
side	String	Yes	Trade direction: buy buy sell sell
priceType	String	Yes	Price type: fixed fixed price floating floating price
price	String	No	Fixed unit price Required when priceType=fixed
premium	String	No	Premium rate Required when priceType=floating
minAmount	String	Yes	Minimum trade amount per order in fiat currency
maxAmount	String	Yes	Maximum trade amount per order in fiat currency
quantity	String	Yes	Total ad quantity in cryptocurrency
payMethodIds	List	Yes	Payment method ID array
>payMethodId	String	Yes	Payment method ID. Retrieve via Get Pay Methods. Merchant's accepted payment method
>userPayMethodId	String	No	User payment method ID Required when side=sell. Merchant's collection method
remark	String	No	Ad remarks
tradeTerms	String	No	Trade terms
payTimeLimit	String	Yes	Payment time limit in minutes: 5, 10

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "advId": "1234567890"
  }
}

Response Parameters

Parameters	Type	Description
advId	String	Ad ID