BINANCE SAPI · C2C

Available Ads Category API

Retrieve all applicable peer-to-peer (C2C) advertisement categories supported for a specific client device type.

ENDPOINT

GET /sapi/v1/c2c/ads/getAvailableAdsCategory

Authentication NONE (PUBLIC)

API Group C2C / Ads

Method GET

Response JSON

Overview

This endpoint returns the list of available C2C (P2P) advertisement categories supported by Binance. It is used by merchant platforms, C2C trading bots, and mobile client applications to dynamically determine which ad categories can be listed or queried.

Because this operation does not require cryptographic signatures, it operates as a lightweight public check. Required contextual information (such as clientType) must be passed in the HTTP request headers.

Request Parameters

Header parameters accepted by the endpoint.

Header	Type	Required	Description
`clientType`	STRING	Required	Client Device Type initiating the request (e.g., `WEB`, `APP`, `WEB_MOBILE`).
`x-gray-env`	STRING	Optional	Environment flag identifier used for internal gray/stage testing.
`x-trace-id`	STRING	Optional	Custom client trace ID for request lifecycle tracking and debugging.
`x-user-id`	STRING	Optional	Target user identifier if querying user-specific category access permissions.

Pass Parameters in Request Headers

Unlike standard query endpoints, the mandatory clientType parameter must be placed inside the HTTP Headers of the request rather than the URL query string.

Request Example

Example request using cURL with HTTP headers.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/ads/getAvailableAdsCategory' \
-H 'clientType: WEB'

Response

Example response returned on successful request.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "category": "BUY",
            "name": "Buy Crypto",
            "enabled": true
        },
        {
            "category": "SELL",
            "name": "Sell Crypto",
            "enabled": true
        }
    ],
    "success": true
}

Response Fields

Field	Type	Description
`code`	STRING	Standard Binance status response code (`"000000"` indicates success).
`message`	STRING	Status description or response feedback message.
`data`	ARRAY	List of available advertisement category objects.
`data[].category`	STRING	Internal category identifier (e.g., `BUY`, `SELL`).
`data[].name`	STRING	Human-readable category title displayed in user interfaces.
`data[].enabled`	BOOLEAN	Indicates whether the category is currently active for new advertisement posting.

How It Works

Workflow for fetching available C2C ad categories.

01 Set Client Header Pass clientType (e.g. WEB or APP) in HTTP header.

02 Send GET Request Issue unauthenticated query to Binance C2C SAPI.

03 Parse Categories Extract available and active C2C ad categories.

04 Render UI / Post Ads Populate C2C merchant forms with valid category options.

Common Use Cases

Dynamic Form Building

Populate frontend C2C ad creation forms dynamically with active categories based on the client device type.

C2C Merchant Automation

Validate category availability before issuing automated P2P advertisement posting commands.

Platform Compatibility Checks

Verify whether specific C2C features or ad categories are enabled for Web vs. Mobile App users.