Manage positions, funds and risk

Build account-aware workflows by reading current exposure and available funds before deciding what action to take.

Step-by-step workflow

1. 1

   Read open positions

   Retrieve current positions and identify net quantity, side, product type and available action for each position.

2. 2

   Read holdings and available funds

   Read holdings and funds separately. Holdings represent owned instruments, while funds show the balances available for account activity.

3. 3

   Check supported margin information

   Use the supported margin calculation before submitting an order when the workflow depends on available margin.

4. 4

   Decide whether to exit or convert a position

   Confirm the position, quantity and intended outcome before choosing exit or conversion. Treat these as separate account-changing actions.

5. 5

   Submit the supported position action

   Send the exit or conversion request with the verified attributes. Store the response and avoid repeating the action while its outcome is uncertain.

6. 6

   Refresh and verify account state

   Read positions and funds again after the action. Confirm that the resulting account state matches the intended change.

7. 7

   Verify the result

   Check the relevant API response and account or market-data state to confirm that the workflow completed successfully. If the result is partial or unsuccessful, review the returned status and message before deciding whether to retry or take another action.

Common issues

HTTP/1.1 401 Unauthorized
{"s":"error","code":-8,"message":"Could not authenticate the user"}

HTTP/1.1 400 Bad Request
{"s":"error","code":-50,"message":"Please provide valid order parameters"}

HTTP/1.1 429 Too Many Requests
Retry-After: 1
{"s":"error","message":"Rate limit exceeded"}

Error: socket hang up
ECONNRESET

Related API reference

Continue with AI