BINANCE SAPI · C2C

Merchant Start Rest API

Place a peer-to-peer (C2C) merchant account into temporary resting mode, pausing active storefront intake while maintaining configured advertisements.

ENDPOINT

POST /sapi/v1/c2c/merchant/startRest

Authentication USER_DATA / SIGNED

API Group C2C / Merchant

Method POST

Response JSON

Overview

This endpoint enables Binance C2C (P2P) merchants to trigger resting mode for their merchant profile. Entering resting mode temporarily halts inbound trade volume and updates merchant visibility without requiring advertisements to be manually unpublished or deleted.

Automated trading desks and merchant operators use this endpoint to manage short operator breaks, handle temporary payment gateway throttles, or pause intake during brief inventory reconciliations.

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 for this request. Simply pass the mandatory clientType header inside the HTTP Request Headers.

Request Example

Example POST request using cURL to activate merchant resting mode.

cURL BASH

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

Response

Example response returned on successful request execution.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": true,
    "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`	BOOLEAN	Returns `true` when merchant resting mode is successfully activated.
`success`	BOOLEAN	Indicates overall request execution result.

How It Works

Workflow for putting merchant operations on resting mode.

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

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

03 Verify Status Confirm response returns data: true.

04 Rest Mode Active Merchant enters resting status and pauses order intake.

Common Use Cases

Operator Short Breaks

Temporarily pause inbound trade requests while operators step away from desks without taking down active ads.

Temporary Payment Throttles

Pause incoming transactions while waiting for bank settlement limits or confirmation delays to clear.

Scheduled Rest Routines

Automate intermittent resting intervals throughout high-volume trading sessions using background cron jobs.