三、财务信息
3.3 基础信息
GET
/api/basicISIN、类型、币种、板块、评级等基础信息。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
| market | 必填 | 市场代码,如 NASDAQ |
| symbol | 必填 | 产品代码,如 AAPL;代码里有 & 时要写成 %26 |
说明
data的字段:country、country_code_fund、type、recommendation_mark、update_mode、fundamental_currency_code、currency、sector、isin、logoid;没有值的不输出。logoid是 Logo 的 SVG 原文。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval},数据在 data 里。出错时 HTTP 状态码仍是 200,status 为 500,message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 market is required! / symbol is required! | 缺少 market 或 symbol |
| 200 | status=500 No Symbol | 找不到这个产品,或这个产品没有这类数据 |
示例
GET
/basic?country=america&market=NASDAQ&symbol=AAPL请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 数据
"country": "america", // 国家
"country_code_fund": "US", // 国家代码
"type": "stock", // 类型
"recommendation_mark": 1.577778, // 分析师评级(数值)
"update_mode": "delayed_streaming_900",
"fundamental_currency_code": "USD", // 财务数据币种
"currency": "USD", // 交易币种
"sector": "Electronic technology", // 板块
"isin": "US0378331005", // ISIN
// Logo(SVG 原文)
"logoid": "<svg width=\"56\" height=\"56\" xmlns=\"http://www.w3.org/2000/svg\"><path fill=\"url(#paint0_linear)\" d=\"M…"
},
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": "NASDAQ", // 市场代码
"symbol": "AAPL", // 产品代码
"code": "AAPL", // 产品代码
"interval": null // K 线周期,这类接口不用
}