獲取授權交易賬戶
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"
}
]
}
}