# HiTick 开放平台

HiTick 开放平台面向行情研究、期权分析和 Agent 应用，提供可直接调用的期权基础数据、波动率数据、席位四榜、主观信号、Polymarket Up/Down 和 Trump Statements 数据能力。

平台同时支持 `MCP`、`Skill` 和直接 HTTP API 接入，适合开发者手动编排，也适合让 Agent 直接读取文档后自动完成封装与调用。

## 给 AI Agent 的读取入口

- [AI 阅读导航 llms.txt](https://open.hitick.top/llms.txt)：平台能力、接入方式与 Markdown 文档目录。
- [公开文档全文 llms-full.txt](https://open.hitick.top/llms-full.txt)：随文档发布更新的完整文本。
- [OpenAPI 接口描述](https://open.hitick.top/openapi.json)：公开数据 API 的路径、参数、鉴权与返回结构。

每篇文档均提供原始 Markdown 版本。读取说明无需登录；调用业务数据接口需要用户授权和相应额度。

## Agent 1.2 升级完成通知

**Agent 1.2 已升级完成，现已向所有用户开放。** 新版本更新了文本与 Agent 能力，并新增图片理解，采用峰谷计价。登录后选择 **Orange Agent 1.2** 即可开始使用。

[查看升级说明、能力对比与价格表](./agent/agent-1-2-upgrade.md)

## 平台提供什么

Orange Hitick 当前主要提供六类核心能力：

- 期权基础数据：查询标的目录、到期日、合约列表、实时报价、盘口和成交量等信息
- 波动率数据：查询 ATM 隐波、期权链、Greeks、历史小时快照、隐波时序走势、Gamma Exposure、GEX 小时快照，以及可直接展示的 GEX 图片 URL
- 席位四榜：按交易日和期货合约查询净买、净卖、买方持仓、卖方持仓四组榜单
- 主观信号：直接获取可用于分析、筛选和策略研究的主观因子结果
- Polymarket Up/Down：查询预测市场相对开盘基准价的 Up/Down 合约定价倾向
- Trump Statements：查询特朗普 Truth Social 内容和白宫正式内容

## 为什么适合 AI / Agent

- 接口结构稳定，适合工具化封装
- 参数语义清晰，适合大模型理解与自动调用
- 返回结构统一，方便 Agent 继续整理、推理和总结
- 同时提供 MCP、Skill 和 HTTP API 三种接入方式

## 为什么推荐直接接入 Agent

- Agent 可以直接读取文档并生成调用逻辑，减少手动写胶水代码
- MCP 接入更适合长期使用，后续新增能力通常更容易自动同步
- Skill 接入适合让 Agent 按文档自动生成封装逻辑
- 对“先找数据，再分析，再筛信号”的探索式工作流更友好

## 当前接口总览

| 能力模块 | 主要用途 | 典型接口 / 能力 | 推荐方式 |
| --- | --- | --- | --- |
| 基础数据 | 获取标的目录、到期日、合约和实时基础报价 | REST 支持 `basic-data/catalog`；MCP 使用 `orange_resolve_subject` 后调用 `by_underlying`、`by_expire`、`by_symbol` | Agent 不请求全量目录 |
| 波动率数据 | 获取 ATM 隐波、PCR、期权链、Greeks、时序走势、GEX、GEX 小时快照和 GEX 图片 | REST 支持 `vol-data/groups`；MCP 使用 `orange_resolve_subject` 后调用 `by_*`、`snapshot_*`、`ts_*`、`gex_*` | 适合让 Agent 按查询链路自动调用 |
| 席位四榜 | 查询期货席位净买、净卖、买方持仓、卖方持仓 | `GET /api/v1/seat-analysis/query` | 适合按日期和合约让 Agent 直接查询并总结 |
| 主观信号 | 直接获取可用于筛选和研判的信号结果 | `subjective-signal/factors`、`evaluate` | 适合由 Agent 直接执行并总结结果 |
| Polymarket Up/Down | 查询相对开盘基准价的预测市场涨跌定价倾向 | `GET /api/v1/polymarket/up-down` | 适合查询单个 symbol 或比较全部最新快照 |
| Trump Statements | 查询特朗普公开言论和白宫正式内容 | `GET /api/v1/trump/statements`；MCP 使用 `orange_trump_statements` | 适合按时间范围检索并让 Agent 总结来源明确的内容 |

## 推荐使用顺序

1. 从 [如何接入](./如何接入.md) 开始，优先使用 MCP 接入
2. 如果你希望 Agent 按文档自动生成封装，使用 Skill 接入
3. 如果你需要完全自定义调用逻辑，再直接调用 HTTP API

## 文档入口

- [如何接入](./如何接入.md)
- [视频教程：Agent 连接与使用、价波矩阵、卖权机会、波动率期限结构、瞄期打权](./video-tutorials.md)
- [绑定飞书失败了怎么办](./troubleshooting/feishu-binding-failed.md)
- [基础数据 API / Skill 文档](./api/basic-data-skill.md)
- [波动率数据 API / Skill 文档](./api/vol-data-skill.md)
- [席位四榜 API / Skill 文档](./api/seat-analysis-skill.md)
- [主观信号 API / Skill 文档](./api/subjective-signal-skill.md)
- [Polymarket Up/Down API / Skill 文档](./api/polymarket-up-down-skill.md)
- [Trump Statements API / Skill 文档](./api/trump-statements-skill.md)

## 建议

如果你是第一次接入，建议先让 Agent 直接接入 Orange Hitick，再逐步扩展自己的调用链路。