获取授权交易账户
GET/api/v1.0/accounts/authorized_trd_accs查询当前授权用户下的交易账户列表。后续交易接口路径里的 acc_id,使用本接口返回的 account_id(写成十进制字符串)。
怎么选账户
- 先看
security_firm,确认是您要交易的券商主体。 - 再看
enable_market(数字枚举,见 enable_market),确认账户支持目标市场。例如2表示美股;查单、查成交时对应的trd_market一般是US。 - 同一券商下有多账户时,再按
acc_type(如现金 / 保证金)和业务需要选择;能交易该市场的授权账户只有一个时可直接使用,多于一个时请明确指定,不要默认第一个。 - 日本账户:下单、查最大买卖数量等还需从
sub_accounts选取可下单的sub_acc_id传入;非日本券商忽略该字段。 account_id在 JSON 里可能是超过 JavaScript 安全整数的数字,客户端请按字符串或 BigInt 处理,不要用 Number 解析后再拼进 URL。
请求参数
无。
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
accounts | list[account] | 授权交易账户列表 |
account 结构体
详见 命名词典 > account。
| 字段 | 类型 | 说明 |
|---|---|---|
account_id | uint64 | 交易业务账户 ID。JSON 为数字;超过 JavaScript 安全整数时不要用 Number 解析。 |
security_firm | security_firm | 券商信息 |
enable_market | list[uint32] | 支持的交易市场,取值参见 命名词典 |
univs_account_card_number | string | 综合账户卡号(16 位) |
acc_type | acc_type | 账户类型 |
account_card_number | string | 业务账户卡号(16 位) |
sub_accounts | list[sub_account] | 仅日本。该账户下可选的子账户(按子账户类型各一条),仅返回可下单的子账户。非日本券商为空或不下发。 |
sub_account(子账户结构)
日本账户下的子账户对象,包含在 sub_accounts 列表中。
| 字段 | 类型 | 说明 |
|---|---|---|
sub_acc_type | sub_acc_type | 仅日本。子账户类型。 |
sub_acc_id | string | 子账户 ID。下单时作为 sub_acc_id 传入。 |
响应示例
json
{
"s": "ok",
"d": {
"accounts": [
{
"account_id": 281756476993717634,
"security_firm": "FUTUSECURITIES",
"enable_market": [
5
],
"univs_account_card_number": "1001283068381087",
"acc_type": "margin",
"account_card_number": "1001305036210273"
},
{
"account_id": 281756479194114175,
"security_firm": "FUTUSECURITIES",
"enable_market": [
1,
10,
14,
16
],
"univs_account_card_number": "1001283068381087",
"acc_type": "margin",
"account_card_number": "1001317823161276"
}
]
}
}