List accounts
Query parameters
For a firm-control list scoped by Identity user (without the ops projection), prefer
GET /v1/firm-control/accounts?user_id=.
Firm Backoffice Reads
Accounts (admin query)
Account snapshots, filters, and details.
⌘I
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Account snapshots, filters, and details.
GET /v1/admin/query/accounts
| Param | Required | Notes |
|---|---|---|
firm_id | yes (or X-Firm-ID) | Auto-injected for firm API keys. |
owner_user_id | no | Filter by account owner Identity user UUID (repeatable / comma-separated). |
user_id | no | Alias for owner_user_id. Invalid values return 400 (not silently ignored). |
status | no | Account status filter. |
account_type | no | Account type filter. |
product_type | no | Product type filter. |
query | no | Search account_name, nickname, or account id. |
cursor, limit | no | Cursor pagination. |
GET /v1/firm-control/accounts?user_id=.
curl -sS "$TRADARA_BASE_URL/v1/admin/query/accounts?status=ACTIVE&limit=100" \
-H "X-Tradara-Api-Key: $TRADARA_API_KEY"
{
"items": [
{
"account_id": "5b1c...",
"user_id": "8e9a...",
"plan_reference": "eval-50k",
"phase": 1,
"status": "ACTIVE",
"realized_pnl": "125.00",
"equity": "50125.00",
"created_at": 1700000000000,
"as_of": 1750000000000
}
],
"next_cursor": null
}
POST /v1/admin/query/accounts/filter
{
"and": [
{ "field": "plan_reference", "op": "in", "value": ["eval-50k", "eval-100k"] },
{ "field": "equity", "op": "<", "value": "49000" }
],
"order_by": "equity",
"limit": 100
}
GET /v1/admin/query/accounts/{accountID}