BINANCE SAPI · C2C

Search Ads with Condition API

Search, filter, and browse active peer-to-peer (C2C) advertisements matching specific criteria including fiat currency, crypto asset, payment channels, transaction volume, and seller publisher types.

ENDPOINT

POST /sapi/v1/c2c/ads/search

Authentication NONE (PUBLIC)

API Group C2C / Ads

Method POST

Response JSON

Overview

This public endpoint executes real-time market searches across Binance peer-to-peer (C2C) order books. It allows applications, automated arbitrage bots, and trading clients to search for active BUY or SELL advertisements filtered by target fiat currency, asset, payment methods, merchant verification status, and specific trade amounts.

Because this request is unauthenticated, it does not require cryptographic signatures or API keys, making it optimal for scanning liquidity, monitoring market pricing, and populating P2P order books.

Request Parameters

Parameters accepted in Body and HTTP Headers.

Parameter	In	Type	Required	Description
`clientType`	Header	STRING	Required	Client Device Type initiating the request (e.g., `WEB`, `APP`).
`asset`	Body	STRING	Required	Cryptocurrency asset symbol to search (e.g., `USDT`, `BTC`).
`fiat`	Body	STRING	Required	Target fiat currency symbol (e.g., `USD`, `EUR`, `UAH`).
`tradeType`	Body	STRING	Required	Order book side: `BUY` or `SELL`.
`page`	Body	INT	Optional	Pagination page index (starts at `1`).
`rows`	Body	INT	Optional	Number of records returned per page (default `10`, max `20`).
`payTypes`	Body	ARRAY	Optional	List of payment method identifiers (e.g., `["BANK_TRANSFER", "REVOLUT"]`).
`transAmount`	Body	NUMBER	Optional	Target fiat transaction amount to filter ads with compatible order bounds.
`publisherType`	Body	STRING	Optional	Publisher filter: `merchant` for verified merchants or `null` for all users.
`countries`	Body	ARRAY	Optional	Array of country code strings to filter advertiser geographic regions.

Transaction Amount Filtering

Supplying transAmount automatically eliminates ads whose minSingleTransAmount or maxSingleTransAmount limits fall outside your target order size.

Request Example

Example POST request using cURL to search USDT buying ads.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/search' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "asset": "USDT",
  "fiat": "USD",
  "tradeType": "BUY",
  "page": 1,
  "rows": 10,
  "payTypes": ["BANK_TRANSFER"],
  "publisherType": "merchant"
}'

Response

Example response returned on successful ad search.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "adv": {
                "advNo": "1122334455667788",
                "price": "1.00",
                "surplusAmount": "2500.00",
                "minSingleTransAmount": "100.00",
                "maxSingleTransAmount": "1500.00",
                "tradeMethods": [
                    {
                        "identifier": "BANK_TRANSFER",
                        "tradeMethodName": "Bank Transfer"
                    }
                ]
            },
            "advertiser": {
                "userNo": "usr12345678",
                "nickName": "FastTrader",
                "userType": "merchant",
                "monthOrderCount": 450,
                "monthFinishRate": 0.99
            }
        }
    ],
    "total": 1,
    "success": true
}

Response Fields

Field	Type	Description
`code`	STRING	Standard status code (`"000000"` indicates success).
`data`	ARRAY	List of matching advertisement records and publisher profiles.
`data[].adv.advNo`	STRING	Unique C2C advertisement number identifier.
`data[].adv.price`	STRING	Current advertisement offer price per crypto unit.
`data[].adv.surplusAmount`	STRING	Remaining cryptocurrency liquidity available for trading.
`data[].advertiser.nickName`	STRING	Display nickname of the advertisement owner.
`data[].advertiser.monthFinishRate`	NUMBER	30-day order completion rate percentage of the merchant.

How It Works

Workflow for searching C2C advertisements.

01 Set Search Filters Select asset, fiat, payTypes, and volume parameters.

02 Send POST Search Issue query request to /sapi/v1/c2c/ads/search.

03 Parse Results Evaluate prices, merchant stats, and liquidity.

04 Select Best Ad Pick optimal offer for trade execution or arbitrage.

Common Use Cases

P2P Order Book UI

Build real-time P2P order book interfaces displaying top buy and sell advertisement offers.

Arbitrage Opportunity Scanning

Continuously poll active C2C offers to find profitable spread opportunities between exchanges and payment providers.

Best Rate Discovery

Filter ads by transaction volume and specific bank channels to discover the best execution prices.

← Previous Endpoint Update Ads API Next Endpoint → Post An Ad API

Related Binance API Endpoints

📚

Part of the Spot Arbitrage Guide

This article is part of our complete learning guide covering professional cross-exchange cryptocurrency arbitrage.

Explore the Spot Arbitrage Guide →

📚

Part of the Binance P2P Automation Guide

This article is part of our complete learning guide covering Binance P2P automation, merchant tools, and automated trading.

Explore the Binance P2P Automation Guide →

Novelty