Accounts
Get accounts
POST /api/tool/execute
Returns the authenticated user's connected brokerage accounts, balances, brokerage capabilities, and connection status.
OAuth scopes: brokerage:read, tool:execute
Plan: Trade It Pro
Returns: Account[], each wrapped with its brokerage_metadata and connection
Request body
tool_name*stringSelects this API operation.
get_accountsParameters for this operation.
refreshbooleanWhen true, requests the freshest available brokerage data. Real-time refresh requires a Pro plan and has a 1 minute per-account cooldown. Omit or false to return the last synced data.
Example request
curl https://api.tradeit.app/api/tool/execute \
--request POST \
--header "Authorization: Bearer $TRADE_IT_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"tool_name": "get_accounts",
"params": {}
}'Example response
200 OK
[
{
"account": {
"id": 304,
"connection_id": 395,
"external_id": "rh-304",
"name": "Robinhood x1234",
"balance": { "amount": 15420.5, "currency": "USD" },
"cash": { "amount": 3420.5, "currency": "USD" },
"buying_power": { "amount": 3420.5, "currency": "USD" },
"created_at": "2026-01-03T15:20:10.000Z",
"updated_at": "2026-03-17T13:55:02.000Z",
"synced_at": "2026-03-17T13:55:02.000Z"
},
"brokerage_metadata": {
"id": 1,
"name": "Robinhood",
"fractional_support": true,
"minimum_order": 1,
"options_support": true,
"take_profit_support": false,
"stop_loss_support": false
},
"connection": {
"id": 395,
"status": 1
}
}
]Brokerage capability fields let your application validate features before showing them to a user.
Note
Use account.id, not connection.id or account.external_id, as the account_id in holdings and trade requests.