Saltar al contenido principal
AUTOP2PAPI

Changelog

SAPI version history, breaking changes, and API updates. Entries are tracked from the official SAPI v7.4 PDF and supplemented with production discoveries.

Breaking Change

2026 — Percent-Encoding Required for HMAC Signatures

Binance now requires query string parameters to be percent-encoded before computing the HMAC-SHA256 signature. Previously, raw query strings were signed directly.

OLD (broken after 2026)
query = "asset=USDT&fiat=USD&timestamp=1700000000000"
sig = hmac_sha256(secret, query)
NEW (required from 2026)
query = urllib.parse.urlencode(params)
sig = hmac_sha256(secret, query)
# urlencode handles percent-encoding

Impact: all HMAC-signed endpoints (auth: hmac, adaptive). Endpoints with headers-only or no auth are unaffected. AutoP2P uses urllib.parse.urlencode() which is compliant.

2024-05-08

SAPI v7.4 Release

Official Release

Version 7.4 of the Binance C2C SAPI PDF documentation. This is the most recent official release used as the primary reference for this documentation site.

Added — 6 new endpoints

EP-29
POST /sapi/v1/c2c/chat/getRiskWarningTips

Chat risk warning before order

EP-30
POST /sapi/v1/c2c/chat/image/pre-signed-url

Pre-signed S3 URL for image uploads

EP-33
GET /sapi/v1/c2c/chat/retrieveChatCredential

WebSocket credential for real-time chat

EP-34
GET /sapi/v1/c2c/chat/retrieveChatMessagesWithPagination

Paginated chat history

EP-41
POST /sapi/v1/c2c/commission-rate/overview

Commission rate overview

EP-42
POST /sapi/v1/c2c/commission-rate/taker

Taker commission rate

Modified — 1 endpoint

EP-7
POST /sapi/v1/c2c/ads/update

Price-only update pattern documented: sending only advNo + price eliminates error 187049. Sending surplusAmount in the same request triggers volume-sync errors.

Removed — 7 endpoints

The following endpoints were deprecated and removed in v7.4. They may still respond on older Binance API versions but should not be used in new integrations.

GET /sapi/v1/c2c/ads/getAdsByToken
POST /sapi/v1/c2c/ads/batchUpdateStatus
POST /sapi/v1/c2c/orderMatch/getUserInfo
POST /sapi/v1/c2c/orderMatch/completeOrder
GET /sapi/v1/c2c/merchant/getMerchantInfo
POST /sapi/v1/c2c/chat/sendMessage
POST /sapi/v1/c2c/chat/getMessages

Future Changes Tracking

The following are known areas where Binance may introduce breaking changes. Monitor these when upgrading:

active

Signature encoding

Percent-encoding enforcement is rolling out. See breaking change above.

watch

EP-37 URL path

AutoP2P uses /user/getPayMethodByUserId (POST). PDF documents /paymentMethod/getPayMethodByUserId (GET). Monitor for deprecation of either path.

watch

Adaptive auth endpoints

EP-13 and EP-24 use adaptive auth (tries HMAC, falls back to api-key, then headers). Binance may standardize auth requirements.

watch

BAPI search endpoint (EP-0)

p2p.binance.com/bapi/c2c/v2 is an undocumented public endpoint. No SLA guarantee. May require stealth headers to avoid rate limiting.

← Pricing AutomationAPI Overview →