BINANCE SAPI · C2C

Ads List with Pagination API

Query and filter user peer-to-peer (C2C) advertisements with flexible pagination, status filters, date ranges, and sorting parameters.

ENDPOINT

POST /sapi/v1/c2c/ads/listWithPagination

Authentication NONE (PUBLIC)

API Group C2C / Ads

Method POST

Response JSON

Overview

This endpoint provides a paginated listing of Binance peer-to-peer (C2C) advertisements. It allows developers and merchant management systems to fetch and search advertisements filtered by cryptocurrency asset, fiat currency, trade direction (BUY/SELL), advertisement status, and specific date windows.

C2C trading platforms, automated market-making software, and merchant dashboards rely on this endpoint to display interactive advertisement tables, monitor active order volumes, and track current advertisement listings.

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`).
`page`	Body	INT	Optional	Current page number for pagination (starts at `1`).
`rows`	Body	INT	Optional	Number of record rows returned per page (e.g., `10`, `20`).
`asset`	Body	STRING	Optional	Cryptocurrency asset symbol filter (e.g., `USDT`, `BTC`).
`fiatUnit`	Body	STRING	Optional	Fiat currency symbol filter (e.g., `USD`, `EUR`, `UAH`).
`tradeType`	Body	STRING	Optional	Trade direction filter: `BUY` or `SELL`.
`advStatus`	Body	INT	Optional	Advertisement status code filter.
`advNo`	Body	STRING	Optional	Specific advertisement number string to filter results.
`startDate`	Body	STRING	Optional	ISO-8601 start date timestamp, e.g. `2026-08-01T00:00:00Z`.
`endDate`	Body	STRING	Optional	ISO-8601 end date timestamp, e.g. `2026-08-13T23:59:59Z`.
`sort`	Body	STRING	Optional	Sorting field key identifier.
`order`	Body	STRING	Optional	Sort ordering direction: `ASC` or `DESC`.

Pagination Best Practice

When querying large datasets, always supply page and rows parameters to ensure efficient data transfer and stay within standard payload response boundaries.

Request Example

Example POST request using cURL with pagination parameters.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/listWithPagination' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "page": 1,
  "rows": 10,
  "asset": "USDT",
  "fiatUnit": "USD",
  "tradeType": "BUY"
}'

Response

Example response returned on successful request.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 1,
        "page": 1,
        "rows": 10,
        "list": [
            {
                "advNo": "1122334455667788",
                "tradeType": "BUY",
                "asset": "USDT",
                "fiatUnit": "USD",
                "price": "1.00",
                "surplusAmount": "5000.00",
                "advStatus": 1
            }
        ]
    },
    "success": true
}

Response Fields

Field	Type	Description
`code`	STRING	Standard Binance status code (`"000000"` indicates success).
`data.total`	INT	Total count of matching advertisements found.
`data.page`	INT	Current page number returned.
`data.rows`	INT	Number of rows per page in the result set.
`data.list`	ARRAY	Array of advertisement detail objects matching the query parameters.

How It Works

Workflow for querying paginated advertisement records.

01 Set Search Filters Define asset, fiat currency, and tradeType parameters.

02 Specify Pagination Set page number and desired rows per page.

03 Send Payload POST request to listWithPagination endpoint.

04 Process List Render paginated records in tables or dashboard views.

Common Use Cases

Merchant Dashboard Tables

Build interactive UI tables with page controls for C2C merchants to monitor their active and historical listings.

Ad Inventory Sync

Periodically crawl active merchant advertisements to update external application database records.

Filtered Ad Searches

Locate specific ads quickly by filtering by advNo, date ranges, or advertisement statuses.