云端API接口调用文档
⚠️ 接入权限规则:
VIP会员(Lv3)及以上:可调用全部云端API(包括单票/批量计算、完整数据返回)。
高级会员(Lv2):仅可调用部分脱敏接口(如历史趋势脱敏、离线模板下发、云端序列计算limited模式),不可调用实时计算接口(/api/v1/calc)。
免费用户(Lv0)/普通会员(Lv1):所有云端API统一返回403无权限。
一、接口基础信息
接口地址:https://www.garyyue.online/api/v1/calc
请求方式:GET(单只) / POST(单只/批量)
身份凭证:用户中心内复制API-Token作为请求token参数
PC客户端在线测算不走云端API接口,复用网页表单会话提交逻辑,扣费、次数由网页后端管控,不受API批量、日限额约束。通达信副图指标为独立本地程序,和云端API权限分开管控。
二、GET单只股票(单标的查询)
GET /api/v1/calc?token=xxx&code=600000&money=10
- token:必填,个人密钥
- code:6位A股代码
- money:可用资金,单位万元,浮点数字
三、POST接口
1、单只:传code+money;2、批量:传codes数组+money
{
"token":"xxx",
"money":10,
"codes":["600000","000001"]
}
- VIP默认批量上限5只,超出返回403;可付费扩容批量名额
- VIP云端单日总调用上限800次,超限返回429
- 管理员无批量、无次数上限
四、错误码说明
- 400:参数格式错误(代码/资金格式非法)
- 403:无API调用权限 / 批量超限未扩容
- 429:VIP云端API当日调用次数超出800次上限
- 428:本地通达信指标单日调用超限(该错误由客户端本地检测并弹窗提示,云端API不会返回此状态码)
- 500:标的历史K线不足61根,无法完成算法测算
五、会员权限总结
Lv0免费 / Lv1注册:禁用全部云端API,仅可用网页+PC客户端;无任何本地指标使用权限。
Lv2高级会员:可加载通达信指标查看行情,指标仅内存瞬时运算、不落地本地硬盘、无法导出实盘因子,本地指标单日上限120次、单票20次(超限428报错);
云端API方面:可调用部分脱敏接口(如历史趋势脱敏、离线模板下发、云端序列计算limited模式),不可调用实时计算接口(/api/v1/calc)。
Lv3 VIP会员:云端全接口开放,通达信指标自动落地本机,数据可导出做策略因子,云端单日800次额度。
Lv4 管理员:云端+本地指标全权限无任何限制,可自由开关本地指标落地开关。