二、HTTP 行情与 K 线

2.7 账号使用情况

GET/api/use/{type}/times

查当前密钥本周期的额度和已经用掉的次数。

请求

请求头 Authorization：你的密钥（必填）。

参数	是否必填	说明
type	必填	写在路径里：要查哪个接口，如 mini_prices、mini_list
market	可选	市场代码
country	可选	查财务信息接口的额度时带上，如 country=america

字段	说明
status	是否查到：true / false
msg	查不到时的原因；正常为 null
total	本周期的总额度
used	本周期已经用掉的次数
format	周期的写法：yyyyMMdd 表示按天
times	查询时的时间，毫秒

剩余次数 = total − used。这个接口的返回类型固定是 application/json。

说明

行情接口和财务信息接口（请求里带 country 的）额度分开计算：查财务信息那一份时，请求里带上 country。
正式环境和测试环境的额度也是分开的，各查各的。
定期查一下即可，不要每次业务请求前都查。

错误

HTTP	返回	情况
200	{"status":false,"msg":"没有订阅产品权限","times":null,"total":null,"used":null,"format":null}	没有这个接口的权限，或接口名写错
200	{"status":false,"msg":"无效秘钥或者已经到期",…}	密钥无效
200	{"status":false,"msg":"缺少秘钥",…}	没带密钥

示例

GET/use/mini_prices/times?market=NASDAQ

请求头 Authorization: 你的密钥 · HTTP 200

{
  "status": true,          // 是否查到
  "msg": null,             // 查不到时的原因，正常为 null
  "times": 1791196826829,  // 查询时的时间，毫秒
  "total": 1000000,        // 本周期的总额度
  "used": 11028,           // 本周期已经用掉的次数
  "format": "yyyyMMdd"     // 周期的写法：yyyyMMdd 表示按天
}