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
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json