Referencia de la API de Ads
8 endpoints para gestionar anuncios P2P — crear, leer, actualizar y controlar el estado. Incluye el patrón crítico de actualización solo de precio.
Crítico: Actualizaciones Solo de Precio (EP-7)
Al actualizar el precio de un anuncio, envía únicamente advNo + price. Incluir surplusAmount provoca el error 187049 porque Binance valida el surplus contra un valor en caché que puede estar desactualizado.
CORRECTO
{"advNo": "123", "price": "1050.50"}MAL — provoca 187049
{"advNo": "123", "price": "1050.50",
"surplusAmount": "5000.00"}Nomenclatura: adsNo vs advNo
getDetailByNo→ usaadsNo(query string)update→ usaadvNo(JSON body)updateStatus→ usaadvNos(plural, JSON body)- Respuestas de búsqueda → devuelven
advNoen los objetos de anuncio
Endpoints
EP-2
Get Ad Detail By Number
POST
/sapi/v1/c2c/ads/getDetailByNoHMAC-SHA256AutoP2P VerifiedCritical
EP-3
Get Ads Reference Price
POST
/sapi/v1/c2c/ads/getReferencePriceNo AuthFrom PDF
EP-4
List Ads With Pagination
POST
/sapi/v1/c2c/ads/listWithPaginationHMAC-SHA256AutoP2P Verified
EP-5
Post An Ad
POST
/sapi/v1/c2c/ads/postHMAC-SHA256From PDF
EP-6
Search Ads (SAPI)
POST
/sapi/v1/c2c/ads/searchHeaders OnlyFrom PDF
EP-7
Update Ad
POST
/sapi/v1/c2c/ads/updateHMAC-SHA256AutoP2P VerifiedCritical
EP-8
Update Ads Status
POST
/sapi/v1/c2c/ads/updateStatusHMAC-SHA256AutoP2P Verified