BINANCE SAPI · C2C

Set Merchant Online API

Switch the merchant operational presence to online mode, indicating active readiness to execute orders across peer-to-peer (C2C) listings.

ENDPOINT

POST /sapi/v1/c2c/merchant/getOnline

Authentication USER_DATA / SIGNED

API Group C2C / Merchant

Method POST

Response JSON

Overview

This endpoint transitions a merchant's presence status to online on the Binance C2C (P2P) market. Activating online presence displays an active indicator next to the merchant profile, reassuring counterparties that trades will receive immediate attention and rapid processing.

Automated trading software, bot scripts, and merchant terminals trigger this endpoint during startup routines, shift commencements, or when recovering from temporary disconnections.

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 merchant permission checks.

HTTP POST with Empty Body

No JSON payload body is required. Simply pass the mandatory clientType header inside the HTTP Request Headers.

Request Example

Example POST request using cURL to set merchant presence online.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/merchant/getOnline' \
-H 'clientType: WEB'

Response

Example response returned on successful execution.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": null,
    "success": true
}

Response Fields

Field	Type	Description
`code`	STRING	Standard Binance status code (`"000000"` indicates success).
`message`	STRING	Response execution feedback or status description.
`data`	NULL / VOID	Void return payload on successful execution.
`success`	BOOLEAN	Indicates overall request execution result.

How It Works

Workflow for setting merchant presence online.

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

02 Send POST Request Call /sapi/v1/c2c/merchant/getOnline endpoint.

03 Verify Status Confirm response returns code: "000000".

04 Presence Online Merchant indicator updates to active/online across listings.

Common Use Cases

Bot Startup Initialization

Ensure trading bots automatically flag the merchant account online upon launch and successful balance checks.

Shift Commencement

Quickly signal operator readiness at the start of operating shifts.

Reconnection Recovery

Re-establish active online status automatically after handling network reconnects or server maintenance.