参考

Wiki

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

参考

K 线返回字段速查

K 线返回 8 个字段：date、open、last、high、low、volume、amount、turnover。两个最容易踩的点：收盘价字段叫 last 不叫 close；所有数值都是字符串，不是数字。

参考

单位速查

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

参考

复权口径

K 线价格固定用前复权，没有 adjust 参数。除权除息日不跳空，所以拿去做均线、形态不会被除权缺口骗 —— 但也别把别处的不复权数据拼进来，那会二次复权。

参考

返回信封字段

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

参考

代码格式速查

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

参考

数据时间口径

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

参考

空结果不等于故障

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