orchard-data-mcp

orchard-data-mcp

适用于 orchard-data 的 MCP 服务——通过 x402 为 AI Agent 提供按次付费的市场数据（在 Base 上使用 USDC 进行微支付）。 无需账户、API 密钥或订阅。

10 秒即可试用——无需钱包，无需注册

npx -y orchard-data-mcp

无需任何凭据，即可将其添加到任意 MCP 客户端：

{ "mcpServers": { "orchard-data": { "command": "npx", "args": ["-y", "orchard-data-mcp"] } } }

无需配置钱包，即可立即使用两个工具：

免费工具	可获取内容
list_products	所有端点及其当前价格
get_feed_status	每个数据源的时效——在付费前验证数据是否最新

先让你的 Agent 调用 get_feed_status。如果数据源已过时，你可以免费了解到这一点；我们不会隐瞒数据过时的情况来诱使你付费调用。

付费工具的费用为 $0.001–$0.10，需要一个存有少量 USDC 的 Base 一次性钱包——下方提供设置说明。如果没有密钥，它们会说明所需费用，而不会悄无声息地失败。

付费使用的理由

可供你审计的历史表现。 预测会在结果揭晓之前标注时间戳，并由服务器根据实际结果，按照载荷中附带的固定规则进行评分。支付 $0.01 调用 get_track_record，先检查我们的准确率，再决定是否信任我们出售的其他内容。这个领域里几乎没有其他服务允许你这么做，因为几乎没有其他服务经得起这样的检验。

此外，还有由真实算法交易系统生成的 ML 市场状态预测和新闻催化剂雷达——美国市场交易时段内约每 15 分钟刷新一次，并始终报告数据是否过时。

工具

工具	每次调用价格	说明
list_products	免费	产品清单，含实时价格
get_feed_status	免费	数据新鲜度探测——付费前检查由 rig 提供数据的产品是否为最新
run_backtest ⭐	$0.10	在最多 10 年的真实日线数据上回测你自己的入场规则：按次日开盘价成交（无前视偏差），计入滑点，分别评估训练集和测试集，并始终打印买入并持有与 SPY 基准；若两部分结果不一致，则报告为噪声
get_symbol_dossier	$0.02	一次调用获取一个股票代码的信息：报价 + 1 年技术指标 + 预期波动幅度 + 市场状态 + 新闻催化因素。可替代约 6 次调用，价格低于这些调用的总价
get_regime_forecast ⭐	$0.01	ML 波动率市场状态预测 + 透明的规则解读（VIX 区间、已实现波动率百分位、趋势）
get_track_record ⭐	$0.01	按类别标准化的胜率 + 服务端评分的预测记录。在购买其他任何内容前先审查我们的表现
get_catalyst_radar ⭐	$0.01	显示有新鲜新闻催化因素（看涨 + 看跌）的股票代码及相关新闻标题：交易系统的 AI 扫描结果；系统空闲时则提供已说明来源的 12 小时新闻标题扫描
get_dip_radar ⭐	$0.01	对交易系统实际运行的 55 只股票清单进行实时回调扫描：RSI(2)、距 20 日高点的距离，以及按已披露阈值划分的分级回调标记
get_market_brief	$0.01	一次调用获取 BTC/ETH/SOL + SPY/QQQ/DIA/IWM + 加密货币恐惧与贪婪指数
get_trending	$0.01	StockTwits 热门股票 + r/wallstreetbets 提及次数
get_movers	$0.005	提供实时报价的美国市场涨跌幅最大股票，按绝对涨跌幅排序
get_expected_move	$0.005	期权隐含预期波动幅度（最近到期日的平值跨式组合），适用于任何代码
get_macro	$0.01	国债收益率（13w/5y/10y/30y）、美元指数、黄金、WTI 原油、VIX
get_funding_rates	$0.003	BTC/ETH/SOL 永续合约资金费率（8 小时 + 年化）、下次资金费率时间、标记价格
get_fear_greed	$0.001	加密货币恐惧与贪婪指数，含当前值和前值
get_ohlcv	$0.002	任意美国股票代码的日线 OHLCV 蜡烛图，范围 5d–1y
read_web_page	$0.001	将任意网页转换为简洁的 Markdown（标题、日期、带链接的正文）。抓取失败不收费
verify_email	$0.001	邮箱检查：语法、MX、一次性邮箱、角色账户、SPF/DMARC，并提供判定结果和评分
check_token	$0.005	EVM 代币安全检查：蜜罐、税费、所有者权限、持有人卖出模拟、DEX 流动性及判定结果
get_sec_filings	$0.003	SEC 近期申报文件，解析 8-K 事件并标记可能影响市场的事项
get_insider_trades	$0.005	SEC Form 4 中的内幕买卖记录，含姓名、职位、价格和摘要
check_prompt_injection	$0.002	检查不可信文本中的提示词注入：判定结果、风险评分、触发规则、LLM 评判原因
get_domain_info	$0.002	查询任意域名的 DNS、注册商、注册时长和到期时间、邮件服务商、SPF/DMARC 及风险信号
get_funding_history	$0.002	查询任意 Hyperliquid 永续合约的资金费率：当前费率及最多 7 天的每小时历史数据
get_sentiment_brief	$0.005	一次调用了解市场情绪：加密货币恐惧与贪婪指数 + StockTwits 热门趋势 + WSB 提及次数 + CoinGecko 热门币种
get_fear_greed_history	$0.002	加密货币恐惧与贪婪指数，最近 30 天，含 7 天/30 天均值、趋势和极端日计数
get_stocktwits_trending	$0.01	StockTwits 热门股票代码及关注列表数量
get_wsb_mentions	$0.003	r/wallstreetbets 提及的股票代码，按排名列出，并与 24 小时前比较
get_crypto_trending	$0.002	CoinGecko 搜索量最高的币种（24 小时），含价格和 24 小时涨跌幅
get_prediction_markets	$0.003	交易量最高的开放市场的 Polymarket 实时赔率，可选关键词筛选
get_quote	$0.01	任意美国股票代码的实时报价
get_dip_check	$0.003	检查该股票代码是否正在回调：RSI(2)/RSI(14)/距 20 日高点的距离 + 判定结果
get_etf_quotes	$0.01	一次调用获取 SPY/QQQ/DIA/IWM 报价
get_crypto_spot	$0.003	BTC/ETH/SOL 现货价格 + 24 小时涨跌幅
get_crypto_global	$0.001	加密货币总市值、交易量、BTC/ETH 市场占比
get_yields	$0.002	国债收益率：13w/5y/10y/30y
get_vix	$0.001	当前 VIX
get_commodities	$0.002	黄金、WTI 原油、美元指数
get_fx_rates	$0.001	约 30 种货币的汇率，可指定任意基准货币
get_gas	$0.001	当前 Base + Ethereum Gas 费，并提供转账和兑换的美元成本
⭐ = 我们独有，并非重新包装的供应商数据。

HTTP API 提供的产品比此服务封装的更多，包括 /api/quote、/api/yields、/api/vix、/api/commodities、 /api/crypto-spot、/api/etf-quotes、/api/wsb-mentions 和 /api/stocktwits-trending 等细分接口，以及可免费获取完整样本的 /api/sample。 请参阅清单或 openapi.json。

Agent 技能（无需安装此软件包）

skills/ 中的三个技能会教会任何拥有 x402 钱包的 Agent（例如 x402scan / AgentCash MCP）如何直接通过 URL 调用这些端点：

技能	涵盖内容
agent-tools	读取网页、验证电子邮件、域名查询、提示词注入筛查、低成本大模型调用、令牌安全
market-data	加密货币恐惧与贪婪指数、任意市场的永续合约资金费率、Gas、热门币种、Polymarket 赔率、报价、VIX、收益率、外汇
package-security	任意软件包版本的已知漏洞、lockfile 和 requirements.txt 扫描、虚构或仿冒软件包名称、npm 软件包健康状况（由姊妹服务 pkgpulse 提供）

# 1. Give the agent an x402 wallet (Claude Code shown; see x402scan.com for other clients)
npx @x402scan/mcp install --client claude-code -y
# 2. Add the skills (all three, or pick one with --skill package-security)
npx skills add letom1176-spec/orchard-data-mcp

适用于 skills CLI 支持的任何 Agent（Claude Code、Cursor、Codex 等）。

npm run test:live 会针对生产环境检查技能中的每个 URL 和价格。

支付付费工具

付费工具需要一个专用的小额 Base 钱包，内含 USDC（按这些价格，几美元就能用很久）。请使用一次性钱包，切勿使用主钱包。

{
  "mcpServers": {
    "orchard-data": {
      "command": "npx",
      "args": ["-y", "orchard-data-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x<burner wallet private key>" }
    }
  }
}

未设置 EVM_PRIVATE_KEY 时，两个免费工具仍可使用；付费工具会说明所需费用，而不会静默失败。

支付方式

每次调用付费工具的流程：GET → HTTP 402，返回支付要求 → 客户端使用你的密钥签署 USDC 转账授权 → 携带支付标头重试 → 返回 JSON。对买家而言，结算无需 Gas（通过 x402 facilitator 使用 EIP-3009）。 已在 Base 主网上完成端到端验证。

服务端收取的费用绝不会超过所列价格。 签署前，客户端会将支付请求与工具所列价格进行核对——即工具描述和上表中的价格，测试套件会确保两者一致。支付必须使用 Base 上的 USDC，且金额不得超过该价格。其他任何情况——错误部署、价格变更、ORCHARD_BASE_URL 输入有误——都会被拒绝，不会生成签名。标价为 $0.01 的工具绝不可能让你花费 $1。

错误会说明你是否已付款。 每次失败都会告知你是否已签署付款，因此你可以判断重试是否安全。如果请求在签署后失败，错误会明确说明这一点，并提示你重试前检查钱包，而不是诱导你再次付款。

配置

变量	默认值	用途
EVM_PRIVATE_KEY	未设置	一次性 Base 钱包密钥。未设置 = 仅使用免费工具
ORCHARD_TIMEOUT_MS	30000	单次调用超时时间，防止 API 卡住并使 Agent 无法继续运行
ORCHARD_BASE_URL	生产环境	指向其他部署，例如用于测试

开发

npm test          # offline: stub API, real MCP stdio, real x402 signing with a throwaway key
npm run test:live # check against the production API — free, needs no funds

离线测试套件会端到端覆盖付费流程，包括拒绝价格过高的请求，全程不接触网络或真实钱包。如果本 README 的价格表与服务端收费不一致，测试也会失败。

test:live 不产生任何费用。它会使用新生成的空钱包检查付费流程：签署付款授权不会花费任何资金，因此生产环境必须拒绝该请求；这一拒绝可证明生产环境的支付请求通过了价格上限检查。它会忽略环境中的任何 EVM_PRIVATE_KEY，因此绝不会接触真实钱包。