Account List
GET/api/v1.0/sim-trade/accountsGet the simulated trading business accounts of the logged-in user. Other simulated trading APIs take acc_id from account_id and market from the same account's market_id. US stocks, ETFs and options use the US margin account (market_id=100).
Parameters
No input parameters. User ID is automatically passed via the login session header.
Request Example
bash
curl -s "https://webapi.futunn.com/api/v1.0/sim-trade/accounts" -H "Authorization: Bearer <AccessToken>" | jqResponse Fields
Returns data.accounts[], each element representing a simulated account.
| Field | Type | Description |
|---|---|---|
account_id | string | Business account ID (string; use as acc_id in other trading APIs) |
broker_id | int | Broker ID (currently always 0) |
market_id | int | Account market ID; pass it as the market parameter of other simulated trading APIs. Known values: 1=HK stocks 3=China A-shares 9=HK options 10=HK futures 11=US futures 12=SG futures 13=JP futures 16=JP stocks 100=US margin (US stocks/ETFs/options) 102=KR margin; rely on the actual response |
intra_account_id | int | Business account ID (short display number; currently always 0) |
account_type | int | Account type: 1=personal practice account 2=competition account |
account_title | string | Account title |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"accounts": [
{
"account_id": "80306537",
"broker_id": 0,
"market_id": 100,
"intra_account_id": 0,
"account_type": 1,
"account_title": "US Margin Account [Paper Trading]"
}
]
}
}Error response
HTTP status remains 200. A failed request returns ret_code != 0 and an error object.
json
{
"ret_code": -3,
"ret_msg": "invalid request",
"error": {"code": "invalid_parameter", "message": "invalid request"}
}