BINANCE SAPI · C2C

Set Merchant Offline API

Switch the merchant operational presence to offline mode, updating status visibility across peer-to-peer (C2C) order books.

ENDPOINT

POST /sapi/v1/c2c/merchant/getOffline

Authentication USER_DATA / SIGNED

API Group C2C / Merchant

Method POST

Response JSON

Overview

This endpoint sets a merchant's operational presence to offline status on the Binance C2C (P2P) platform. When a merchant goes offline, their active presence indicator reflects their unavailable state, helping manage incoming counterparty order expectations.

Automated trading systems, merchant applications, and bot daemons use this endpoint during graceful shutdowns, scheduled breaks, or when trading sessions terminate.

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 context validation.

HTTP POST with Empty Body

This request does not require a JSON body payload. Pass the required clientType header inside the HTTP Request Headers.

Request Example

Example POST request using cURL.

cURL BASH

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

Response

Example response returned on successful request 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 status or feedback message.
`data`	NULL / VOID	Void return payload on successful execution.
`success`	BOOLEAN	Indicates overall request execution result.

How It Works

Workflow for setting merchant presence offline.

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

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

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

04 Presence Updated Merchant status is updated to offline across P2P listings.

Common Use Cases

Bot Shutdown Hooks

Ensure trading bots mark merchant accounts offline during process termination or unhandled exceptions.

Shift End Management

Switch merchant presence to offline at the conclusion of daily trading windows.

Operator Availability Toggling

Update presence indicators when support operators or traders leave active workstations.