BINANCE SAPI · C2C

Ads Detail API

Retrieve complete specifications, pricing parameters, limits, and payment methods for a specific C2C advertisement using its unique advertisement number.

ENDPOINT

POST /sapi/v1/c2c/ads/getDetailByNo

Authentication NONE (PUBLIC)

API Group C2C / Ads

Method POST

Response JSON

Overview

This endpoint queries detailed metadata for a single Binance peer-to-peer (C2C) advertisement using its unique identifier (adsNo). It returns comprehensive trade conditions, including real-time offer price, total available asset quantity, minimum/maximum transaction bounds, supported payment methods, and seller merchant requirements.

Trading bots and market monitoring tools use this endpoint to inspect active advertisements before initiating trade execution orders or verifying order eligibility.

Request Parameters

Parameters accepted by the endpoint in Query and HTTP Headers.

Parameter	In	Type	Required	Description
`adsNo`	Query	STRING	Required	Unique advertisement number identifier to query.
`clientType`	Header	STRING	Required	Client Device Type initiating the request (e.g., `WEB`, `APP`).
`x-gray-env`	Header	STRING	Optional	Environment flag identifier used for stage testing.
`x-trace-id`	Header	STRING	Optional	Custom client trace ID for request lifecycle tracking.
`x-user-id`	Header	STRING	Optional	Target user ID for user-specific ad permission checks.

HTTP POST with Query Parameters

Note that while the HTTP method is POST, the mandatory adsNo parameter is passed in the URL query string, and clientType must be included in the HTTP Header.

Request Example

Example request using cURL.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/getDetailByNo?adsNo=1122334455667788' \
-H 'clientType: WEB'

Response

Example response returned on successful request.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "advNo": "1122334455667788",
        "tradeType": "BUY",
        "asset": "USDT",
        "fiatUnit": "USD",
        "price": "1.00",
        "surplusAmount": "5000.00",
        "minSingleTransAmount": "100.00",
        "maxSingleTransAmount": "2000.00",
        "tradeMethods": [
            {
                "identifier": "BANK_TRANSFER",
                "tradeMethodName": "Bank Transfer"
            }
        ],
        "status": 1
    },
    "success": true
}

Response Fields

Field	Type	Description
`advNo`	STRING	Unique C2C advertisement ID string.
`tradeType`	STRING	Side of the advertisement: `BUY` or `SELL`.
`asset`	STRING	Cryptocurrency asset symbol (e.g., `USDT`, `BTC`).
`fiatUnit`	STRING	Local fiat currency symbol (e.g., `USD`, `EUR`, `UAH`).
`price`	STRING	Current unit price offered in the advertisement.
`surplusAmount`	STRING	Remaining tradable asset amount available on the ad.
`minSingleTransAmount`	STRING	Minimum order limit per single C2C trade transaction.
`maxSingleTransAmount`	STRING	Maximum order limit per single C2C trade transaction.
`tradeMethods`	ARRAY	Supported payment methods configured for this advertisement.

How It Works

Workflow for querying advertisement details.

01 Obtain Ad Number Get target adsNo from market list or notification.

02 Issue Request Send POST request with query parameter & clientType header.

03 Validate Ad Terms Check remaining surplusAmount, price, and payment methods.

04 Initiate Trade Proceed to place trade order based on validated terms.

Common Use Cases

Real-Time Ad Audit

Verify whether a specific advertisement is still active and has sufficient liquidity before triggering automated orders.

Price Monitoring

Track targeted competitor advertisement price movements and available order volumes dynamically.

Payment Method Validation

Confirm that the advertisement supports payment channels compatible with your local settlement account.