交易
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
该接口用于获取包括账户、股票代码、持仓股数、可用股数、持仓均价(按账户设置计算均价方式)、币种在内的股票持仓信息。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | array | 可选 | 股票代码,使用 `ticker.region` 格式,例如:`AAPL.US` |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
list | object[] | 可选 | 股票持仓信息 |
└ account_channel | string | 可选 | 账户类型 |
└ stock_info | object[] | 可选 | 股票列表 |
└ ∟ symbol | string | 可选 | 股票代码 |
└ ∟ symbol_name | string | 可选 | 股票名称 |
└ ∟ currency | string | 可选 | 币种 |
└ ∟ quantity | string | 可选 | 持仓股数 |
└ ∟ available_quantity | string | 可选 | 可用股数 |
└ ∟ cost_price | string | 可选 | 成本价格 (具体根据客户端选择平均买入还是摊薄成本) |
└ ∟ market | string | 可选 | 市场 |
└ ∟ init_quantity | string | 可选 | 开盘前初始持仓 |
响应 JSON 示例
{
"code": 0,
"data": {
"list": [
{
"account_channel": "lb",
"stock_info": [
{
"symbol": "700.HK",
"symbol_name": "TENCENT",
"currency": "HKD",
"quantity": "650",
"market": "HK",
"available_quantity": "-450",
"cost_price": "457.53",
"init_quantity": "214"
},
{
"symbol": "9991.HK",
"symbol_name": "BAOZUN-SW",
"currency": "HKD",
"market": "HK",
"quantity": "200",
"available_quantity": "0",
"cost_price": "32.25",
"init_quantity": "214"
},
{
"symbol": "TCEHY.US",
"symbol_name": "Tencent (ADR)",
"currency": "USD",
"market": "US",
"quantity": "10",
"available_quantity": "10",
"init_quantity": "18"
},
{
"symbol": "2628.HK",
"symbol_name": "CHINA LIFE",
"currency": "HKD",
"market": "HK",
"quantity": "9000",
"available_quantity": "0",
"init_quantity": "8000"
},
{
"symbol": "5.HK",
"symbol_name": "HSBC HOLDINGS",
"currency": "HKD",
"market": "HK",
"quantity": "2400",
"available_quantity": "2000",
"init_quantity": "2000"
},
{
"symbol": "BABA.US",
"symbol_name": "Alibaba",
"currency": "USD",
"market": "US",
"quantity": "2000209",
"available_quantity": "2000209",
"init_quantity": "214"
},
{
"symbol": "2.HK",
"symbol_name": "CLP HOLDINGS",
"currency": "HKD",
"market": "HK",
"quantity": "2000",
"available_quantity": "2000",
"init_quantity": "2000"
},
{
"symbol": "NOK.US",
"symbol_name": "Nokia",
"currency": "USD",
"market": "US",
"quantity": "1",
"available_quantity": "0",
"init_quantity": "1"
}
]
}
]
}
}错误码
参见错误码文档。