CryptoStruct Market Data

CryptoStruct MCP 服务

面向 cryptostruct.com 的官方远程 MCP 服务——提供历史加密货币和预测市场数据（来自包括 Kalshi 和 Polymarket 在内的 35 家交易场所的逐笔每日文件），以及实时市场统计数据，专为交易员、量化分析师和 AI Agent 打造。

本仓库介绍托管服务。无需在此安装或运行任何内容——该服务由 CryptoStruct 运营。

• 端点： https://cryptostruct.com/mcp（Streamable HTTP，无状态，JSON 模式）
• OAuth 端点： https://cryptostruct.com/mcp/auth（工具相同；返回 401 和 WWW-Authenticate，以触发标准 OAuth 流程——动态客户端注册 + PKCE）
• 服务卡片： /.well-known/mcp/server-card.json
• 文档： https://cryptostruct.com/docs/mcp · 产品文档：https://docs.cryptostruct.com

无需 API 密钥——目录、市场统计数据和访客购买流程均可免密使用。通过 OAuth 登录（可选）可关联你的 CryptoStruct 账户，以查看订单历史、下载已购文件并使用账户余额付款——所有操作始终需要你的同意（参见购买数据）。

快速开始

Claude Code

claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth

Cursor / 通用 JSON 配置

{
  "mcpServers": {
    "cryptostruct": {
      "url": "https://cryptostruct.com/mcp"
    }
  }
}

claude.ai — 设置 → 连接器 → 添加自定义连接器 → https://cryptostruct.com/mcp/auth

你可以做什么

• 目录与发现： 搜索 35 家交易场所的约 50 万种交易品种（现货、永续合约、期货、期权、预测市场），日级归档数据覆盖范围可追溯至 2021-02-08。
• 预测市场： Kalshi 和 Polymarket 事件合约是一级交易品种，可在目录中搜索（class=prediction），并像任何加密货币交易品种一样提供覆盖范围、实时快照和分钟／日级聚合数据。合约报价范围为 0..1（USD）；成交额以 USD 计价。
• 市场统计数据： 实时快照和分钟／小时／日级聚合数据——OHLC、VWAP、交易次数、成交额、价差、盘口最优档深度；滑点／市场冲击曲线。
• 购买数据： 原始逐笔文件——加密货币和预测市场交易品种均包括在内——每个交易品种日收费 €1。银行卡付款：服务会提供 Stripe 结账 URL——用户在浏览器中完成付款，服务绝不会接触银行卡详细信息。无需购买即可获取免费的完整日样本文件。
• 余额与 Agent 授权（OAuth 登录）： 未经用户同意，Agent 绝不会使用账户余额。默认情况下，create_checkout 会返回 approval_required 和一个审批页面，用户可在其中确认订单（使用余额或银行卡付款）或放弃订单；未获批准的订单会在 24 小时后过期，不会扣费。用户可在 https://cryptostruct.com/account/agents 选择启用限额内的自主购买（单笔订单和滚动 24 小时限额）——之后，余额可全额支付的订单会立即完成；超过限额的订单则需要用户审批。Agent 还可额外传入自己的 max_credit_cents。preview_checkout 会提前告知 Agent 可能出现的三种结果。这些设置只能在网站上更改，不能通过 Agent 的令牌更改。
• 账户工具（OAuth 登录）： 列出订单、获取已购文件的下载 URL、查看订阅、余额和 Agent 消费设置。

工具

工具	描述	层级
get_data_dictionary	数据字典与产品参考（文件格式、单位、定价）	免费
search_instruments	搜索交易品种目录	免费
list_venues	列出支持的交易场所	免费
get_instrument	交易品种详情	免费
get_coverage	指定交易品种按日统计的存档覆盖情况	免费
list_sample_files	免费的全天样例文件	免费
get_price_quote	一组数据文件的价格报价	免费
get_market_snapshot	实时市场快照（60 分钟 + 24 小时）	免费
get_daily_stats	日度汇总（免费提供 30 天–180 天；365 天/最大范围需 Premium）	免费
get_hourly_stats	小时汇总（免费提供 7 天–90 天；180 天需 Premium）	免费
get_slippage	滑点/市场冲击曲线（免费提供 1 小时；24 小时/7 天需 Premium）	免费
get_top_instruments	按实时 24 小时成交额排名的热门交易品种	免费
get_movers	24 小时涨跌幅榜（涨幅最高与跌幅最大）	免费
get_minutes_range	用于事件研究的历史分钟序列	Premium
create_checkout	开始购买 — Stripe URL（银行卡）或 approval_required / 直接购买（使用额度，取决于用户的同意设置）	commerce
get_checkout_status	通过 session_id（银行卡）或 order_id（已登录；额度/审批订单）查询结账状态	commerce
get_order_files	列出已付款订单的文件及下载 URL	commerce
request_file_restore	恢复已归档（冷存储）的文件	commerce
list_my_orders	我的订单	sign-in
get_my_files	我购买的文件	sign-in
get_my_subscription	我的订阅、额度余额和 Agent 消费设置	sign-in
preview_checkout	购买预演：已拥有/不可用的文件、额度覆盖情况，以及 create_checkout 将完成购买、请求审批还是转交给 Stripe	sign-in

层级： free/commerce 无需密钥即可使用。sign-in 需要通过 OAuth 验证登录（任意账户均可）。premium 工具/参数需要 CryptoStruct Premium（€20/月）——同时可解锁更长的统计窗口（日度 365 天/最大范围、小时 180 天、滑点 24 小时/7 天）、更大的搜索限制、get_market_snapshot 中的数据质量区块，以及 5 倍调用额度。超出所属层级的调用将返回静态的 AUTH_REQUIRED / PREMIUM_REQUIRED 错误和升级 URL，不会导致硬性失败。

速率限制

按调用方加权计算预算：无密钥时为 120 单位/分钟（按 IP 计算），或按已登录用户计算；Premium 为 600 单位/分钟。开销低的目录读取计 1 单位，上游开销较大的统计计 3–5 单位，结账计 10 单位。遇到 RATE_LIMITED 错误时，请等待错误中指示的秒数后重试。

约定

• 所有文件大小均为压缩后（zstd）的字节数；市场价值以 USD 计；售价以 EUR 计。
• 上游保留分钟粒度数据约 30 天；小时/日度汇总可追溯到更早时间。
• Tick 文件是全天 JSON-lines 格式的记录（订单簿快照与更新、交易、强平、资金费率、标记价格/指数价格，包括期权希腊值）。格式参考：Market Data Protocol。

相关

• 用于解析 tick 文件的 Agent Skill：cryptostruct-market-data（zip）
• Skills 发现索引：/.well-known/agent-skills/index.json
• API 目录（RFC 9727）：/.well-known/api-catalog
• llms.txt：https://cryptostruct.com/llms.txt

支持

如有疑问或问题，请访问：https://cryptostruct.com/contact