Switch player mode

Each 4Cx account has a single active player mode at a time:

cash — orders settle against your cash balance and liability.
coins — orders settle in Gold Coins. See Place coins orders for the full denomination rule.

The current mode is returned as data.user.playerMode on Log in and on /user/getMe. Call this endpoint to flip it before placing an order in the other mode.

This setting is account-wide and persists across sessions. Switching modes does not cancel your existing open offers in the previous mode, but new orders will be placed against the newly selected mode.

Request

POST https://api.4cx.io/user/updateCoinsOrCash POST

Headers: Authorization, Content-Type: application/json

Field	Type	Description
`playerMode`	string	Must be exactly `"coins"` or `"cash"`. Any other value returns `400`.

{
  "playerMode": "coins"
}

{
  "data": {
    "success": true
  }
}

curl -X POST https://api.4cx.io/user/updateCoinsOrCash \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"playerMode":"coins"}'

Errors

Status	Message	Cause
`400`	`Error! Invalid method of play`	`playerMode` was not `"coins"` or `"cash"`.
`401`	`InvalidCredentials`	Missing or invalid `Authorization` token.

Typical flow

Log in and inspect data.user.playerMode from the response.
If you want to take in coins and the user is in cash, POST /user/updateCoinsOrCash with { "playerMode": "coins" }.
Proceed to Place order. See Place coins orders for the denomination rule.
To return to cash trading, repeat with { "playerMode": "cash" }.

Overview

Coins-only takes

Authentication

Markets / Exchange

Coins

Orders

Errors & Rate Limits

Switch player mode

Request

Errors

Typical flow

​Request

​Errors

​Typical flow

Request

Errors

Typical flow