三、财务信息
3.4 各周期涨跌幅
GET
/api/performance一个产品近一周、一个月、三个月、半年、今年以来、一年、五年、十年、全部时间的涨跌幅。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
| market | 必填 | 市场代码,如 NASDAQ |
| symbol | 必填 | 产品代码,如 AAPL;代码里有 & 时要写成 %26 |
说明
data里是perf_of_开头的 9 个字段:w、1m、3m、6m、ytd、y、5y、10y、all;数值是百分比(5 表示 5%)。- 外壳里的
market为 null。
返回
统一外壳 {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
/performance?country=america&market=NASDAQ&symbol=AAPL请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": { // 数据
"country": "america", // 国家
"perf_of_6m": 31.270653029110942, // 近 6 月涨跌幅(%)
"perf_of_1m": 2.088017989078056, // 近 1 月涨跌幅(%)
"perf_of_3m": 13.453692370461033, // 近 3 月涨跌幅(%)
"perf_of_ytd": 22.565242144313235, // 今年以来涨跌幅(%)
"perf_of_y": 30.05553931598948, // 近 1 年涨跌幅(%)
"perf_of_w": -0.6993215093441324, // 近 1 周涨跌幅(%)
"perf_of_all": 259888.4688503132, // 全部时间涨跌幅(%)
"perf_of_10y": 1084.2427468725048, // 近 10 年涨跌幅(%)
"perf_of_5y": 135.39080135440182 // 近 5 年涨跌幅(%)
},
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": null, // 市场代码
"symbol": "AAPL", // 产品代码
"code": "AAPL", // 产品代码
"interval": null // K 线周期,这类接口不用
}