Create a trading account

Create a new trading account for a user. Starting balance precedence is: explicit account initial_balance, then the selected Phase initial_balance, then the Challenge initial_balance. When phase_id is omitted or null, the account uses the first phase for challenge_id; provide phase_id to create the account for a specific phase in that challenge.

POST /api/accounts/

cURL

BasicTradingAccount

curl --request POST \
  --url https://api.example.com/api/accounts/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": 123,
  "challenge_id": 1,
  "is_active": true
}
'

201

{
  "success": true,
  "results": [
    {
      "account_id": 282,
      "user_id": 50,
      "prop_firm_id": "08dfcf0b-005f-4e6a-84fc-d0348ed66a4e",
      "prop_firm_slug": "firm-demo",
      "challenge_id": 1,
      "challenge_short_code": "001122",
      "account_name": "John Doe - 50K Challenge",
      "initial_balance": 100000,
      "current_balance": 100000,
      "is_active": true,
      "allowed_symbols": [
        "EURUSD",
        "GBPUSD",
        "USDJPY",
        "AUDUSD",
        "XAUUSD",
        "XAGUSD",
        "US30",
        "US100",
        "US500"
      ],
      "max_drawdown": 12000,
      "max_open_positions": 10,
      "max_contracts": 5,
      "notes": "Passed Phase 1 and Phase 2 evaluation. Ready for live trading with full symbol access.",
      "created_at": "2026-02-19T19:54:41.763500Z",
      "updated_at": "2026-02-19T19:54:41.763516Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

Token-based authentication with required prefix "Token"

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

user_id · integer · required

ID of the user who will own the trading account.

challenge_id · integer · required

Challenge or program identifier associated with the account. The first phase for the challenge is used.

phase_id · integer | null

Optional exact phase identifier for the account. When provided, it must belong to the selected challenge. When omitted or null, the first phase for the challenge is used.

initial_balance · string<decimal> | null

Optional account-level starting balance override. Precedence is explicit account initial_balance, then the selected Phase initial_balance, then the Challenge initial_balance.

Pattern: ^-?\d{0,12}(?:\.\d{0,2})?$

is_active · boolean · default: true

Whether the account is active immediately after creation.

notes · string | null

Optional notes or comments to store with the account.

Maximum string length: 2000

Response

201 - application/json

Standard serializer for operation responses. A command or a task should return a response matching this format. Operation = a request to perform some action, e.g. sync, update, delete, create, etc.

success · boolean · required

Indicates whether the operation completed successfully.

results · any[] · required

List containing the result items produced by the operation. The structure of each item depends on the executed operation.

summary · object · required

Aggregated summary information about the operation results (e.g. counts of updated, created, failed or unchanged records).

Show child attributes

duration_ms · number<double> · required

Execution time of the operation in milliseconds.

message · string | null

Optional human-readable message describing the operation outcome.