BINANCE SAPI · C2C

Get User Orders Statistic API

Query aggregated trade statistics, active order metrics, and historical completion summaries for the authenticated peer-to-peer (C2C) account.

ENDPOINT
GET /sapi/v1/c2c/orderMatch/getUserOrderSummary
Authentication USER_DATA / SIGNED
API Group C2C / Order Match
Method GET
Response JSON

Overview

This endpoint provides an overview of a user's peer-to-peer (P2P) trading activity. It returns aggregated statistical summaries including pending order counts, active trade processing volumes, 30-day order totals, and overall completion performance metrics.

Automated trading desks, merchant control panels, and analytics dashboards invoke this endpoint to monitor real-time order loads, prevent concurrency bottlenecks, and track operational KPIs.

01

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 for context validation.
i
HTTP GET Query

This is a parameterless GET endpoint. Simply pass the mandatory clientType header inside the HTTP Request Headers.

02

Request Example

Example GET request using cURL to fetch order statistics.

cURL BASH
curl -X GET \
'https://api.binance.com/sapi/v1/c2c/orderMatch/getUserOrderSummary' \
-H 'clientType: WEB'
03

Response

Example response returned on successful request execution.

RESPONSE 200 OK
{
    "code": "000000",
    "message": "success",
    "data": {
        "processingOrderNum": 2,
        "completedOrderNum": 450,
        "finishRate": 0.985,
        "avgReleaseTime": 120,
        "avgPayTime": 180,
        "monthOrderCount": 125,
        "monthFinishRate": 0.992
    },
    "success": true
}

Response Fields

Field Type Description
code STRING Standard Binance status code ("000000" indicates success).
data.processingOrderNum INT Count of currently open/in-progress P2P orders awaiting payment or escrow release.
data.completedOrderNum INT Lifetime count of successfully completed orders.
data.finishRate DOUBLE All-time trade completion rate ratio (e.g., 0.985 equals 98.5%).
data.avgReleaseTime INT Average crypto release duration in seconds.
data.avgPayTime INT Average payment confirmation time in seconds.
data.monthOrderCount INT Total number of orders executed within the rolling 30-day period.
data.monthFinishRate DOUBLE Order completion rate percentage over the rolling 30-day window.
04

How It Works

Workflow for retrieving account trading metrics.

01 Set Headers Pass clientType (e.g. WEB or APP) in HTTP header.
02 Send GET Request Call /sapi/v1/c2c/orderMatch/getUserOrderSummary.
03 Extract Metrics Parse pending orders, 30-day count, and finish rates.
04 Dashboard Update Render real-time KPIs or throttle new trade acceptance.

Common Use Cases

Concurrency Throttling

Inspect processingOrderNum to automatically pause new orders when active capacity limits are reached.

Merchant KPI Monitoring

Track completion rates, average release times, and 30-day order counts to maintain VIP merchant tiers.

Performance Dashboards

Display real-time trading statistics and operational velocity metrics inside custom admin control panels.



💬
Telegram WhatsApp