2.7 请求账号使用情况

查询当前账号在指定接口和交易所下的调用额度及已使用次数。

接口信息

项目	内容
接口路径	/use/{type}/times
请求方法	GET
鉴权	需要
返回格式	JSON

请求参数

参数	位置	类型	必填	实际参数	说明
type	Path	string	是	prices或者mini_prices	指定需要查询用量的接口
market	Query	string	是	交易所代码，参考 3.7	指定需要查询用量的交易所

请求格式：

/use/{type}/times?market={market}

范例：

/use/mini_prices/times?market=NASDAQ

接口类型

账号是否支持某个 type，以实际权限和服务端配置为准。

返回结构

字段	类型	说明
State	integer	业务状态
Code	integer/string	业务代码
Msg	string	状态说明
data	object/array	账号用量数据

用量字段

字段	类型	允许为空	说明
total	integer/string	是	当前统计周期允许的总调用额度
used	integer/string	是	当前统计周期已经使用的调用次数
format	string	是	统计周期或服务端返回的周期格式
times	integer/string	是	用量统计时间

数值字段可能返回为数字或数字字符串。客户端应先判断空值，再转换为整数。

剩余调用次数可以由客户端计算：

remaining = total - used

当计算结果小于 0 时，客户端应按 0 处理。

接口行为

• 用量按照访问密钥、接口类型和交易所分别统计。
• 不同接口可能使用不同的调用额度。
• 不同交易所也可能使用不同的额度配置。
• total 和 used 的统计周期以 format 返回值及账号配置为准。
• 查询用量接口本身是否计入调用次数，以服务端实际配置为准。
• 客户端不应将某个接口的剩余额度应用到其他接口。

空数据

返回空数据可能表示：

• type 不受支持；
• 交易所代码无效；
• 账号没有对应接口权限；
• 账号没有对应交易所权限；
• 服务端没有当前周期的用量记录。

客户端应同时检查业务状态、接口类型、交易所代码和账号权限。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 type	补充接口类型
type 无效	使用支持的接口类型
缺少 market	补充交易所代码
交易所代码无效	参考 3.7 核对交易所代码
used 大于或等于 total	停止或降低对应接口的调用频率
返回空数据	检查接口权限和交易所权限

HTTP 状态码为 200 不一定表示业务成功，客户端还需要检查业务状态和返回数据。

使用限制

• 一次请求只能查询一个接口类型和一个交易所。
• 用量结果只适用于当前访问密钥。
• 客户端应定期查询，不建议每次业务请求前都查询用量。
• 接近额度上限时，应降低调用频率或暂停非必要请求。
• 实际调用额度和统计周期以账号配置为准。

参数名称	参数类型	是否必填	参考值	参数说明
Authorization	string	是	请联系管理员	认证密钥

4、响应说明

4.1 正常响应

{
    "status": true,//状态
    "msg": null,//null
    "times": 1745689352858,//查询时间
    "total": 100000,//指定市场下，指定类别下总次数，通常账号多个市场和多个类别都会使用一个计数系统，他们会统一
    "used": 1,//指定市场下，指定类别下已经使用的次数
    "format": "yyyyMMdd"//更新周期，yyyyMMdd表示天，yyyyMMddHH表示小时，yyyyMMddHHmm表示分钟，yyyyMMddHHmmss表示按秒。
}

4.2 没有权限

{

    “status”: false,

    “msg”: “没有订阅产品权限”,

    “times”: null,

    “total”: null,

    “used”: null,

    “format”: null

}