Binance API / SAPI / C2C
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.

ParameterInTypeRequiredDescription
clientTypeHeaderSTRINGRequiredClient Device Type initiating the request (e.g., WEB, APP, WEB_MOBILE).
fiatBodySTRINGRequiredFiat currency symbol to inspect commission rates for (e.g., USD, EUR, UAH, KES).
x-gray-envHeaderSTRINGOptionalEnvironment flag identifier used for internal gray/stage testing.
x-trace-idHeaderSTRINGOptionalCustom client trace ID for request lifecycle tracking and debugging.
x-user-idHeaderSTRINGOptionalTarget 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

FieldTypeDescription
codeSTRINGStandard Binance status code ("000000" indicates success).
messageSTRINGExecution status feedback or message.
data.fiatSTRINGTarget fiat currency symbol evaluated in the query.
data.makerCommissionRateSTRINGBase commission fee rate charged for advertisement makers (e.g., 0.0015 = 0.15%).
data.takerCommissionRateSTRINGCommission rate applied to order takers (typically 0.0000).
data.merchantTierINTCurrent merchant tier level determining fee discounts.
data.discountRateSTRINGVolume or tier discount percentage applied against the base rate.
data.effectiveMakerRateSTRINGNet final maker commission rate after all tier discounts are applied.
successBOOLEANIndicates 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