双十一机构版年付 ¥1,699/年查看年付
参考

Wiki

参考资料区:字段速查、口径说明、常见误用。比教程短,按需要查。

参考
K 线返回字段速查

K 线返回 8 个字段:date、open、last、high、low、volume、amount、turnover,不随周期变。两个最容易踩的点:收盘价字段叫 last 不叫 close;所有数值都是字符串,不是数字。

查看
参考
单位速查

同一个字段名在不同端点单位可能不同:volume 一律是手,但 amount 在 K 线里是元、在 snapshot 里是万元。拿错单位会差 100 倍到 1 万倍。

查看
参考
复权口径

日 / 周 / 月 / 季 / 年线固定用前复权,除权除息日不跳空,拿去做均线、形态不会被缺口骗;分钟线不复权,给的是原始价。没有 adjust 参数,也不用自己复权。

查看
参考
返回信封字段

每个端点返回的外层结构都一样,共六个字段。数据本身在 data 里,形态不止一种;另外有些错误(缺参数、超限、付费端点没带 Key)走的是另一套返回,别按信封去解析。

查看
参考
代码格式速查

代码一律写成「市场前缀 + 代码」,前缀必须小写。A 股 sh/sz/bj、港股 hk、美股 us;ETF、可转债、板块各有各的代码段。不带前缀的裸代码在行情端点会返回空。

查看
参考
数据时间口径

判断数据新不新,看返回里的日期字段,不要看你的系统时间。不同市场各自的最新交易日不同;各端点更新节奏也不一样,从约 10 秒到按交易日盘后都有。

查看
参考
空结果不等于故障

返回空数组多半不是接口坏了,而是这次确实没有数据 —— 代码格式写错、非交易日、数据尚未披露都会这样。空结果不扣次数,先按下面几项自查。

查看
参考
返回形态速查

同样是 data,形态有四种:行数组、表列表、已排版文本、多段结构。取数前先判类型,否则会在"该按 data[0] 取"的地方去读字段,或者反过来。

查看
参考
字符串数值

行情、指标、财务这些端点的数值是字符串("1723.50"),不是数字。直接做算术、比较或排序会出问题 —— 转换前先确认类型。

查看
参考
批量取数

只有部分端点支持一次传多个代码,而且每个端点拼回来的方式都不一样 —— 有的多一列 symbol,有的把代码拼进列名。传之前先确认它属于哪一种。

查看
参考
跨市场差异速查

行情类字段各市场一致,但公司资料、分红、股本类字段各市场不同;另外有端点只覆盖 A 股。跨市场写代码时先看这张表。

查看