Skip to main content
POST
/
api
/
v1
/
wallet
/
mode
curl --request POST \
  --url https://mcp.echozero.app/api/v1/wallet/mode \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{}'
{
  "success": true,
  "data": {
    "isVirtualMode": true,
    "message": "<string>"
  }
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Optional -- when omitted, HMAC verification is skipped.

​
x-timestamp
string

Request timestamp in epoch milliseconds. Required when x-signature is provided. Rejected if drift exceeds 5 minutes.

Body

application/json

OpenAPI: McpWalletToggleModeBodyDto. GraphQL: WalletModeArgs in apps/gql-main/src/wallet/args/walletMode.args.ts.

​
isVirtualMode
boolean

true = virtual trading mode, false = real wallet mode (omit to use server default toggle behavior)

Response

200 - application/json

Updated mode.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload