thinchain

ThinChain

连接原始经纪商数据与 AI 交易 Agent 的催化转化器。

经过实战检验。 清洗逻辑提取自一款生产环境中的期权交易应用，能够处理 Tradier 在生产环境中抛出的所有异常行情。

☁️ 准备投入生产？

开源服务可使用你自己的 API 密钥在本地运行。 如需支持多经纪商故障转移、SLA 保证和 Webhook 告警的托管基础设施，请 加入托管云候补名单。

问题

Tradier 的 MCP 会导出包含 500 行的 JSON 期权链。一个异常报价就可能扰乱 Agent 的推理。ThinChain 会在数据到达你的模型之前对其进行清洗、压缩并执行熔断。

安装

git clone https://github.com/snipmcp/thinchain.git
cd thinchain
pip install -e ".[dev]"
cp .env.example .env

或使用 Docker：

docker-compose up --build

配置

TRADIER_API_KEY=your_key_here
TRADIER_BASE_URL=https://api.tradier.com/v1
POLYGON_API_KEY=your_key_here
POLYGON_BASE_URL=https://api.polygon.io
DEFAULT_BROKER=tradier
CACHE_TTL_SECONDS=30
LOG_LEVEL=INFO

用法

以下是发送给 Claude（或任何兼容 MCP 的 Agent）的三个示例提示词：

1. Use get_compressed_chain to get an iron condor setup on SPY expiring 2026-06-19
2. Check if SPY options data is trustworthy before I place my trade
3. Get me the ATM straddle strikes for AAPL expiring 2026-06-19

在两个终端中运行

# Tab 1 — start the MCP server
python -m thinchain.server

# Tab 2 — call a tool from a Python shell or your MCP client
# Tool signatures:
#   get_compressed_chain(symbol, expiration, strategy="raw",
#                        delta_range=None, broker="tradier")
#   get_sanitized_quote(symbol, broker="tradier")
#   get_circuit_status(symbol, expiration, broker="tradier")

工作原理

原始经纪商输出与模型之间的三层处理：

Broker API → [Sanitize] → [Compress] → [Circuit Break] → MCP Tool → AI Agent
              hygiene     strategy      anomaly gate
              rules       slicing       + cache

• 清洗：丢弃幽灵报价（0.0/0.0）、倒挂价差、NaN/空值/短横线值；将 Delta 限制在 [-1, 1] 范围内；对看涨期权的正 Theta 进行归一化；标记流动性不足的行权价。
• 压缩：将期权链裁剪为仅包含与你的策略（铁鹰式、跨式等）相关的行权价，通常可减少 95% 以上的 Token。
• 熔断：采用四级数据质量状态（clean / noisy / degraded / circuit_breaker_active）。当异常行超过 65% 时，拒绝提供过时数据，并回退到最近一次已知良好的缓存。

来自实时 SPY 铁鹰式策略的实际数据（到期日为 2026-06-19）

RAW TRADIER PAYLOAD          THINCHAIN OUTPUT
─────────────────────────────────────────────
Rows:        482             Rows:        25
Est tokens:  38,560          Est tokens:  2,000
Token savings:               95%
Anomalous rows removed:      217
Data quality:                noisy → still safely served

ThinChain 将 482 行 / 38,560 个 Token 压缩至 25 行 / 2,000 个 Token，并标记出 217 个异常行权价（流动性不足、幽灵报价、价差过大），避免它们污染 Agent 的上下文。

路线图

• 托管云层级（托管、多租户、Webhook 告警）
• 加固 Polygon 连接器（实时 SIP 数据流）
• 熔断器触发时发送 Webhook 告警

贡献

欢迎提交 PR。提交前请运行 pytest。