BINANCE SAPI · C2C

Get Commission Overview API

Query the active C2C (P2P) merchant fee structure, tiered commission rates, and maker/taker fee percentages for a specified fiat trading market.

ENDPOINT
POST /sapi/v1/c2c/commission-rate/overview
Authentication USER_DATA / SIGNED
API Group C2C / Commission Rate
Method POST
Response JSON

Overview

This endpoint enables peer-to-peer merchants, trading desks, and automated pricing algorithms to inspect the active fee schedules applied to their C2C trading volume. By supplying a target fiat currency symbol (fiat), callers receive comprehensive commission metrics, including maker fee rates, taker exemptions, 30-day volume discount tiers, and currency-specific merchant fee brackets.

Automated market-making bots and arbitrage engines execute this query during spread calculation routines to accurately compute net profitability and adjust advertisement pricing spreads dynamically.

01

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, WEB_MOBILE).
fiat Body STRING Required Fiat currency symbol to inspect commission rates for (e.g., USD, EUR, UAH, KES).
x-gray-env Header STRING Optional Environment flag identifier used for internal gray/stage testing.
x-trace-id Header STRING Optional Custom client trace ID for request lifecycle tracking and debugging.
x-user-id Header STRING Optional Target user identifier for context validation.
i
Dynamic Spread Calculations

Feed the returned makerCommissionRate directly into your bot's pricing formula to ensure that ad spreads fully account for platform fees on every filled order.

02

Request Example

Example POST request using cURL to query commission rates for EUR.

cURL BASH
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/commission-rate/overview' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "fiat": "EUR"
}'
03

Response

Example response returned on successful query execution.

RESPONSE 200 OK
{
    "code": "000000",
    "message": "success",
    "data": {
        "fiat": "EUR",
        "makerCommissionRate": "0.0015",
        "takerCommissionRate": "0.0000",
        "merchantTier": 2,
        "discountRate": "0.10",
        "effectiveMakerRate": "0.00135"
    },
    "success": true
}

Response Fields

Field Type Description
code STRING Standard Binance status code ("000000" indicates success).
message STRING Execution status feedback or message.
data.fiat STRING Target fiat currency symbol evaluated in the query.
data.makerCommissionRate STRING Base commission fee rate charged for advertisement makers (e.g., 0.0015 = 0.15%).
data.takerCommissionRate STRING Commission rate applied to order takers (typically 0.0000).
data.merchantTier INT Current merchant tier level determining fee discounts.
data.discountRate STRING Volume or tier discount percentage applied against the base rate.
data.effectiveMakerRate STRING Net final maker commission rate after all tier discounts are applied.
success BOOLEAN Indicates overall request execution result.
04

How It Works

Workflow for evaluating and applying C2C commission fee schedules.

01 Specify Fiat Pass fiat code in request body payload.
02 Send POST Request Call /sapi/v1/c2c/commission-rate/overview.
03 Parse Effective Rate Extract effectiveMakerRate and active merchantTier.
04 Update Pricing Bot Adjust target ad spreads to preserve target profit margins.

Common Use Cases

Real-Time Profitability Models

Ensure algorithmic trading systems account for exact exchange commissions when calculating net yields across multiple fiat pairs.

Dynamic Ad Spread Tuning

Automatically widen or tighten order book spreads when merchant commission tiers change based on monthly trade volume.

Multi-Fiat Accounting & Auditing

Reconcile fee expenditures and net settlement figures across diverse regional fiat payment channels.



💬
Telegram WhatsApp