Ads API Reference
8 endpoints for managing P2P advertisements — create, read, update, and control status. Includes the critical price-only update pattern.
Critical: Price-Only Updates (EP-7)
When updating an ad's price, send only advNo + price. Including surplusAmount causes error 187049 because Binance validates surplus against a cached value that may be stale.
CORRECT
{"advNo": "123", "price": "1050.50"}WRONG — causes 187049
{"advNo": "123", "price": "1050.50",
"surplusAmount": "5000.00"}Naming: adsNo vs advNo
getDetailByNo→ usesadsNo(query string)update→ usesadvNo(JSON body)updateStatus→ usesadvNos(plural, JSON body)- Search responses → return
advNoin ad objects