Execute Balance Operation

Move money on a trading account — deposit, withdrawal, credit, or bonus.

operation_type and transaction_type are not free text. List the valid values with GET /v1/finance/operation-types and GET /v1/finance/transaction-types before calling this.

amount accepts a number or a string; send a string for exact decimals.

Replaces: POST /api/v1/accounts/{account_number}/balance and POST /api/v1/crm/users/{login_id}/balance. The account is now named in the body rather than in the path.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

A balance movement. operation_type + transaction_type are business NAMES
resolved live against the OPERATION_TYPE / TRANSACTION_TYPE reference
(see GET /v1/finance/operation-types and /transaction-types); the direction
(add/subtract) comes from the transaction type itself.

string
required
string
required
string
required
required
length ≤ 64
Responses

400

Rejected — insufficient funds, or unknown operation / transaction type

401

Invalid or missing API key

403

Access denied (credential scope)

404

Account not found

429

Rate limit exceeded

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json