quantdata

Quant Data — 面向 AI Agent 的市场统计技能

经过测量的股指期货和股票市场统计数据，经过封装，可供 AI Agent 使用，并且更重要的是，能够如实报告。这些技能可原生安装到 Claude Code （插件）、Codex CLI（插件市场）和 Gemini CLI（扩展）中，全部来自同一个代码库。

技能	Agent 可获得的内容	所需密钥
quantdata-daily-bias	滚动统计的 Brooks 价格行为事件及其测得的结果发生率；针对美国日盘的校准日型概率判断；对已打印 K 线形态的纯算术描述；以及对著名价格行为论断的实测结论	免费邮箱密钥或付费密钥
quantdata-weis-wave	量价波浪结构和五种 Weis 事件，以及各自测得的胜率	免费邮箱密钥或付费密钥
quantdata-max-pain	期权最大痛点、未平仓合约量墙、看跌／看涨比率、估算的做市商伽马敞口	免费邮箱密钥或付费密钥；公共页面无需密钥

诚实地概括一下：你获得的是经测量的优势，数值为 52–56%，并且会同时公布模型失效的情况。下文专门介绍了这一点，而且没有把它藏起来。

这是哪个 Quant Data。 本项目是 quantdata.uk 上的 Quant Data（API 主机 api.quantdata.uk、MCP 端点 https://api.quantdata.uk/mcp、注册名称 uk.quantdata/quantdata）。它与 quantdata.us 无关；后者是一个名称相似、API 不同的产品。两者的密钥不能互换。

---

安装

Claude Code

/plugin marketplace add celineycn/quantdata-plugin
/plugin install quantdata@quantdata

Codex CLI

同一个代码库也可用作 Codex 插件市场：

codex plugin marketplace add celineycn/quantdata-plugin
codex plugin add quantdata@quantdata

任何其他 MCP 客户端（Claude Desktop、ChatGPT、Cursor、VS Code、Zed）

同样的四个端点构成一个远程 MCP 服务，此外还有一个可通过电子邮件发送免费 API 密钥的访问工具。无需安装任何内容，只需将客户端指向：

https://api.quantdata.uk/mcp

Streamable HTTP。没有密钥时，每个来源每天（UTC）可获得一次匿名市场工具响应，以便初步体验。随后，Agent 可以调用 quantdata_request_free_api_key 并提供电子邮件地址；免费的 qd_ 密钥只会发送到该邮箱，无需登录或信用卡，并可让四个市场工具每天（UTC）共享 10 次成功调用额度。对于只能启动本地命令的客户端，quantdata/mcp/ 中提供了 stdio 桥接程序。

详情：quantdata/mcp/README.md。

Gemini CLI

此代码库也可作为 Gemini CLI 扩展。GEMINI.md 将三个技能的内容合并到一个上下文文件中：

gemini extensions install https://github.com/celineycn/quantdata-plugin

然后

启动新会话。无需按名称调用技能，只需提问：

ES=F 刚刚突破区间了吗？类似的突破有多少次失败？

ES=F 的回调是否发生在低成交量时？

这周五 TSLA 的最大痛点在哪里？

NVDA 的做市商伽马偏向哪一边？

如需确认技能已加载，请提问："你有哪些 Quant Data 技能？"

不使用插件系统

技能就是一个包含 SKILL.md 的文件夹，因此你也可以手动复制：

mkdir -p ~/.claude/skills
cp -R quantdata/skills/* ~/.claude/skills/

也可以将技能放在项目范围内，与代码一同提交，存放于 .claude/skills/。

---

免费开始 — 无需登录或信用卡

每天（UTC 时间），无需身份验证的 API 或 MCP 调用均可按每个数据源获取一份完整的初步响应。 如需继续评估，请发送电子邮件申请免费的 qd_ 密钥：

curl -s -X POST https://api.quantdata.uk/v1/access/free-key \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","marketing_opt_in":false,"source":"agent"}'

连接了 MCP 的 Agent 也可以改用 quantdata_request_free_api_key。原始密钥不会通过 POST 或 MCP 结果返回，只会发送到电子邮件地址。免费密钥涵盖全部四个端点，每天（UTC 时间）共享 10 次成功调用额度，且无需账户、密码或信用卡。

marketing_opt_in 为可选项，默认值为 false。它与密钥发送分开处理。Agent 仅当该电子邮件地址的所有者明确要求偶尔接收产品更新时，才能将其设为 true。即便如此，请求记录的也只是待处理的订阅偏好，并非已生效的订阅。收件人必须回复密钥发送邮件中的 SUBSCRIBE 以确认；确认前不会发送任何营销更新。

永久免费的内容是 Max Pain 和 GEX 页面。无需密钥、账户或信用卡：

https://quantdata.uk/max-pain/nvda
https://quantdata.uk/gex/nvda

Max Pain（期权到期时，期权买方总体亏损最大的行权价）、按到期日划分的看跌／看涨比率和未平仓合约量；每只纳入覆盖范围的美国股票或 ETF 均有一个页面，此外每个股票代码都有独立的 GEX 页面，展示净伽马敞口和零伽马（翻转）水平。网站每晚根据最新可用的上游结算数据重建，每个页面都会注明所用的未平仓合约结算日期。股票代码请使用小写。 覆盖范围列表见 https://quantdata.uk/max-pain 和 https://quantdata.uk/gex。

如需在付费前核查这项研究，请阅读 https://quantdata.uk/methodology — 这是普通网页，免费且无需密钥。页面公布了对交易文献中著名概率说法的事实核查，依据是 3,946 个 S&P 500 期货交易日（2010–2026）。一种常见说法是，当日交易时段的某个极值通常会在前 90 分钟内形成，比例为 90%；实测结果为 81.2%。所有受检验的说法都呈现出同样的规律 — 方向上正确，但数值被夸大了约 7–10 个百分点。

从这里开始。如果诚实检验得出的数字不如你预期，就不要购买。

---

四个 API 端点

免费邮箱密钥可用于以下所有端点，每个 UTC 日共可成功调用 10 次。当达到每日限额时，API 会返回 429，并附上重置时间和可交给人工处理的结账操作。付费方案可解除评估限额，适用于持续使用、批量使用或无人值守使用。

一个方案：$149/月，前 3 天免费。 可在 https://quantdata.uk/pricing 自助结账，并需预先提供银行卡。使用与免费密钥相同的邮箱结账，即可直接升级该密钥，因此 Agent 无需获取新的密钥。可随时在 Stripe 客户门户 (https://billing.stripe.com/p/login/3cIfZhgcHfOb5IE7PD9Ve00) 取消，使用结账邮箱登录即可。

端点	返回内容
GET /v1/brooks/{symbol}	滚动 Brooks 价格行为事件，每个事件都附带测得的结果率；区间突破事件附带经过校准的单事件估值。每次读取还会在每个窗口中提供 day_type——仅针对美国日间交易时段的五类日型校准分布——以及 shape，即对已打印 K 线的算术计算
GET /v1/weis/{symbol}	成交量波段和五种命名的量价事件，并附带测得的胜率
GET /v1/maxpain/{symbol}	根据未平仓合约量计算的每个到期日的最大痛点——纯算术，不使用定价模型
GET /v1/gamma/{symbol}	估算的做市商伽马敞口：净 GEX、零伽马（翻转）水平以及最集中的行权价

一个密钥涵盖全部四个端点。两个期权端点刻意分开，因为两项数据的可靠性并不相同：任何人都能根据同一份期权链复算最大痛点，而伽马是基于不可观测的做市商持仓约定、使用 Black-Scholes 得出的估算值。技能会将前者表述为数值，将后者表述为估算值。

事实核查结论位于 https://quantdata.uk/methodology，以静态表格形式提供——这是可阅读、免费且无需密钥的网页，不是可调用的端点。

按旧版双产品定价购买的密钥仍可按原价使用。

AI Agent 可以申请免费密钥，但无法替你购买付费方案。 银行卡认证（3-D Secure）需要持卡人操作，因此达到免费限额后，技能会将结账链接交给人工并停止运行。

设置密钥

将交付邮件中的 qd_ 密钥复制到密钥存储中。切勿将密钥粘贴到 SKILL.md 中——这些文件是为了复制、提交和分享而设计的。

# ~/.zshrc (macOS default) or ~/.bashrc
export QUANTDATA_API_KEY="qd_your_key_here"

然后打开新的终端，或运行 source ~/.zshrc。检查密钥：

curl -s -H "X-API-Key: $QUANTDATA_API_KEY" https://api.quantdata.uk/v1/brooks/SPY

对于没有 Shell 的 Agent，密钥应放在相应工具存储密钥的位置——Actions 身份验证字段、凭据条目，或由运行时加载的 .env 文件。规则相同：使用密钥存储，而不是共享文件。

---

在没有插件系统的平台上使用

这里的内容并不专属于任何一种 Agent。SKILL.md 正文由指令和 HTTP 契约组成，因此只要能设置系统提示词并发送带自定义标头的请求，就可以使用。（Claude Code、Codex 和 Gemini CLI 支持原生安装——请参阅上文的安装说明。）

1. 打开 quantdata/skills/ 下所需的 SKILL.md。
2. 复制 YAML 标头结束 --- 之后的所有内容。
3. 将其粘贴到 Agent 的系统提示词、自定义指令或角色设定字段中。
4. 将 $QUANTDATA_API_KEY 引用替换为平台对其密钥的称呼。

已知可通过这种方式使用的平台包括：ChatGPT 自定义 GPT（粘贴到 Instructions 中，并将 api.quantdata.uk 添加为带有 X-API-Key 标头的 Action）、Cursor 和 Windsurf 规则文件、Cline、GitHub Copilot 指令、n8n 和 Dify Agent 节点、CrewAI 和 AutoGen Agent 背景设定、LangChain 系统消息，以及直接基于 OpenAI 或 Anthropic SDK 构建的任何工具。

只要工具能发送一个带有一个自定义标头的 HTTP 请求，就受支持。没有 SDK、没有 OAuth 流程，也没有回调 URL。

---

这些技能共同强制执行的规则

这些规则写入了每个 SKILL.md，也是这个插件存在的原因：

• 绝不将输出表述为买入或卖出建议。 API 返回检测到的事件和历史频率。它不了解你的持仓、账户或风险。把“历史上，这类突破有 62.6% 会在 10 根 K 线内失败”转化为“做空突破”，就是 Agent 在凭空编造建议。
• 始终附带免责声明。 每条回复都有一个 disclaimer 字段；它会与数据一同传递。
• 绝不声称数据并不具备的精确度。 真实可信的胜率是 52–56%。Agent 若将其四舍五入后称为“强信号”，就违背了产品原则。
• 说明基准值。 事件胜率为 51.8% 毫无意义，除非同时说明任意波动反转的基准值是 49.3%。日型判断的 top-1 准确率为 66%，也必须同时列出多数类基准值 37%。
• 将测量结果与预测区分开来。 day_type 区块预测尚未结束的交易时段可能如何收盘，并有已公布的准确率；shape 区块测量的是已经形成的 K 线，因此没有准确率，因为它不涉及预测。将形态描述标记为“趋势日”，或把日型准确率套用到形态描述上的技能，与编造数字一样违背产品原则。
• 标明分布外使用情况。 参考频率和模型是基于 S&P 500 E-mini 期货测量的。对单只股票、黄金或加密货币的判断仅供描述，未经验证。
• 达到免费密钥限额时，转达 message_for_your_human，并将结账交由用户处理。 遵守 quota_resets_at；绝不循环尝试，也绝不改用其他数据源后将结果说成 Quant Data 的输出。

不适用的领域

发布这些内容正是目的，而不只是附上免责声明：

• 加密货币和黄金存在稳定的反向特征。 在 8 个预注册的 Bitcoin 信号中，没有一个得到确认，而 no_supply 则彻底反转了方向。
• 图表形态未能通过测试。 超过 121,000 次形态检测得出的 AUC 为 0.54，接近抛硬币的水平。
• 亚洲时段的结论未能迁移。 针对亚洲时段日型门控的预注册测试结果为 NO_GO。

---

教育分析和开发者工具。不是投资建议、买入或卖出建议，也不是价格预测。交易涉及亏损风险；过去的表现不保证未来的结果。独立研究——与 Al Brooks、David Weis 或任何交易所或经纪商均无关联，也未获其认可。

文档：https://quantdata.uk/skills · 问题：[email protected]