Skip to main content
前提:有效的 Nightwatch 订阅。Data API 包含于订阅,无需额外购买。

1. 生成 API Key

  1. 登录后进入账户页,找到「API 访问」分区。
  2. 点击生成 Key,填一个 label(必填,不超过 64 字符,例如 my-bot)。
  3. Key 明文只在生成时显示一次,立即复制保存。之后列表里只能看到 label 与创建时间,无法再查看明文;丢失只能撤销后重新生成。
每个账户最多同时持有 5 个 active Key;到达上限后需先撤销一个再生成。

2. 第一个请求:/v1/discover

用你的 Key 调用自描述端点,确认鉴权可用并查看当前配额与能力目录:
返回(节选):
discover 不消耗月配额,可以放心用于会话开头的自检。

3. 读懂响应信封

所有端点的成功响应都是同一个形状:业务数据在 data,请求元信息(request_id、数据新鲜度、分页游标等)在 _meta。错误响应则只有 error 对象,包含 codemessagehint 与文档链接。详见通用约定

4. 调一个数据端点

取最新披露的国会议员交易(全市场端点,无参数):
或者取一个标的的 0DTE Dealer GEX 快照:
部分按标的查询的端点在首次请求某个冷门标的时会返回 202——这不是错误,表示数据正在准备,按响应里的 retry_after_seconds 稍后重试即可(通常几秒内就绪)。行为详见数据新鲜度

下一步