patternfetch — Market-State Briefs for AI Trading Agents

patternfetch

**patternfetch 是一个面向 AI Agent 的市场数据 API，涵盖美国股票、ETF 和加密货币现货。**只需一次调用，提供股票代码和时间周期，即可获得精简的市场状态报告：紧凑的蜡烛图数据、检测到的图表形态和蜡烛形态、支撑位和阻力位、市场状态，以及经过解读的指标（RSI、EMA）。每个检测到的形态都附带其经回测得出的历史命中率，以及相对于同一市场中未出现该形态时基准水平的提升幅度，帮助 Agent 判断某种形态是否具有参考价值。六种工具——brief、multi、delta、analogs、scan、capabilities——可通过 REST 和 MCP 访问，支持一键 OAuth、通过 Stripe 或 Base 上的 x402 USDC 进行额度计费、无需密钥的演示端点，以及注册时赠送的 $3 入门额度。提供客观的市场数据，不构成投资建议。

**为什么输出更精简：**对于 BTC/USDT 的 4h（120 根蜡烛），原始 OHLCV 数据约有 3,260 个 token，全部是模型仍需自行分析的数字；patternfetch 的解读结果约有 1,323 个 token，且分析已经完成。复现此结果（无需账户）。

• **覆盖范围：**美国股票和 ETF（经拆股及股息调整，延迟/每日收盘数据，通过 Yahoo 获取）；加密货币现货（实时数据，通过 Binance 获取）。
• 时间周期：1m、5m、15m、30m、1h、4h、1d、1w。
• **访问方式：**REST 地址为 patternfetch.com/v1/*，MCP 地址为 patternfetch.com/mcp（Streamable HTTP），另提供本地 stdio 桥接工具（patternfetch-mcp）。

为什么要看基准率和提升幅度

如果检测器只报告 double_top, confidence 0.92，Agent 无从得知这种形态是否曾具有实际意义。patternfetch 会为每个检测到的形态附加一个 evidence 区块：

{
  "name": "double_top",
  "confidence": 0.92,
  "evidence": {
    "scope": "US stocks & ETFs",
    "tf": "1d",
    "band": "0.75-1.00",
    "horizon": 10,
    "n": 7508,
    "hitRate": 0.431,
    "ci95": 0.011,
    "lift": {
      "baseline": 0.419979,
      "baselineN": 46038,
      "lift": 0.011021,
      "ci95": 0.012075,
      "informative": false,
      "reading": "indistinguishable-from-baseline"
    }
  }
}

hitRate 是可实现的总方向性基准率：在指定时间周期和置信度区间内，该形态历史上互不重叠的出现次数中，后续 horizon 根蜡烛的收盘到收盘收益率按预期方向变动的比例。前向窗口从检测时开始，因此不存在前视偏差。模型未考虑止损、费用或滑点。

lift 将该命中率与同一市场中未出现该形态时的基准水平进行比较。许多形态的结果会显示为 indistinguishable-from-baseline——如实报告这一结果正是本工具的意义所在。Agent 可以根据 informative 进行筛选，而不是盲目信任几何置信度评分。

**校准。**在审计的 105 个类别中，有 3 个落在其置信区间之外；相比之下，仅由随机因素导致的预期数量约为 5.3 个。美国股票类别中，60 个类别无一超出。方法和完整表格： patternfetch.com/pattern-base-rates-study。这项测量可使用开源 honest-signals 工具复现。

快速入门

无需密钥——演示端点为公开端点：

curl -X POST https://patternfetch.com/v1/demo \
  -H 'content-type: application/json' \
  -d '{"ticker":"AAPL","timeframe":"1d"}'

使用密钥（自助开通，赠送 $3 入门额度）：

curl -X POST https://patternfetch.com/v1/keys -d '{"email":"[email protected]"}'

curl -X POST https://patternfetch.com/v1/brief \
  -H 'authorization: Bearer pf_...' \
  -H 'content-type: application/json' \
  -d '{"ticker":"BTC/USDT","timeframe":"4h"}'

JavaScript 客户端：

npm install patternfetch

import { Patternfetch } from 'patternfetch';

const { key } = await new Patternfetch().createKey('[email protected]');
const pf = new Patternfetch({ apiKey: key });

const brief = await pf.brief({ ticker: 'AAPL', timeframe: '1d' });

console.log(brief.analysis.nl);
// "AAPL: uptrend (strong), +0.14% last 1d, RSI 71.66 (overbought),
//  bearish_engulfing (conf 1, hist 41% over 10b, lift -0.7pp vs 42% base (within noise))."

for (const p of brief.analysis.patterns) {
  if (p.evidence?.lift.informative) console.log(p.name, p.evidence.hitRate, p.evidence.lift.lift);
}

工具

共有六个工具，通过 MCP（patternfetch_*）和 REST（POST /v1/*）提供同一组功能。

工具	返回内容	Agent 何时调用
brief	单个代码和时间周期的市场状态报告：精简 K 线、包含基准率和提升幅度的形态、支撑位／阻力位、市场状态、RSI/EMA，以及一句话摘要。	默认选择。需要了解单个市场当前的技术面情况，又不想把原始 OHLCV 数据全部塞进上下文时使用。
multi	每个时间周期各返回一份简报（默认 1h、4h、1d），并提供跨周期一致性解读，明确说明各周期观点一致或背离，例如 1h up / 4h up / 1d down。	想知道某个形态在不同周期上是否得到确认或相互矛盾，又不想分别调用三次 brief 时使用。
delta	仅返回自该代码和时间周期上一次简报以来的变化——趋势反转、新形态、RSI 状态变化。如果没有重大变化，则返回 changed: false。	需要重复轮询同一市场时使用。先调用一次 brief，之后每次轮询调用 delta，将 token 成本降至接近零。
analogs	返回形态与当前价格走势相似的历史区间，以及后续走势的完整分布：固定前瞻周期内的胜率、中位数、均值、最小值、最大值和样本数 n。	想了解某种形态对应的历史结果分布，而不是单点估值时使用。它不是预测，也不是策略回测。
scan	扫描经过筛选的市场范围，包括流动性较好的美国大型股、核心及行业 ETF，以及主要加密货币交易对。可按资产类别、市场状态、形态和最低基准率筛选；结果按基准率排序，并附带 95% CI。每日预计算。	需要在整个市场中寻找候选标的，而不是分析已指定的代码时使用。将候选列表传给 brief。
capabilities	支持的资产、时间周期、端点、限制和定价。无需输入。	首先调用，以免对覆盖范围作出任何假设。

客户端方法

方法	端点
brief({ticker, timeframe, limit?, fields?, market?})	POST /v1/brief
multi({ticker, timeframes?, limit?, market?})	POST /v1/multi
delta({ticker, timeframe, limit?})	POST /v1/delta
analogs({ticker, timeframe, window?, horizon?})	POST /v1/analogs
scan({assetClass?, regime?, pattern?, tf?, minBaseRate?, limit?})	POST /v1/scan
candles({ticker, timeframe})	POST /v1/candles
platforms()	GET /v1/platforms
createKey(email)	POST /v1/keys

MCP

patternfetch 是一个位于 https://patternfetch.com/mcp 的远程 MCP 服务（Streamable HTTP）。 工具：patternfetch_brief、patternfetch_multi、patternfetch_delta、patternfetch_analogs、 patternfetch_scan、patternfetch_capabilities。 发现（initialize、tools/list）免费，无需密钥。只有 tools/call 需要身份验证。

一键 OAuth（无需粘贴任何内容）——在 Claude Code、Claude Desktop、Cursor 或 Smithery 中添加 URL 并授权一次；系统会为你生成一个免费套餐密钥：

claude mcp add --transport http patternfetch https://patternfetch.com/mcp

在 claude.ai 中：Customize → Connectors → Add custom connector → https://patternfetch.com/mcp → Authorize。

或使用 Bearer 密钥——添加到 MCP 配置中：

{
  "mcpServers": {
    "patternfetch": {
      "url": "https://patternfetch.com/mcp",
      "headers": { "Authorization": "Bearer pf_..." }
    }
  }
}

前往 https://patternfetch.com/v1/keys 获取免费密钥（附带少量入门额度）。

本地 stdio 桥接

更倾向于使用本地 stdio 服务（Claude Desktop、沙箱或无法接收入站 HTTP）？此软件包 附带 patternfetch-mcp，这是一个零依赖的 stdio↔HTTP 桥接程序，提供相同的工具， 并将调用转发至 patternfetch.com：

{
  "mcpServers": {
    "patternfetch": {
      "command": "npx",
      "args": ["-y", "patternfetch-mcp"],
      "env": { "PATTERNFETCH_API_KEY": "pf_..." }
    }
  }
}

无需密钥即可使用 tools/list；远程服务无法访问时，会回退到内嵌快照 （mcp-tools.json），因此内省始终可以成功。工具调用支持 PATTERNFETCH_API_KEY、OAuth 或 x402。使用 PATTERNFETCH_MCP_URL 覆盖端点。

从实时服务刷新快照：

curl -s -X POST https://patternfetch.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

定价

注册即可获得 $3 的入门额度，其中至少 $0.50 无需银行卡即可立即使用。之后按次调用并从额度中扣费，可通过 Stripe 或 Base 上的 x402 USDC 充值。Studio 计划：每月 $19，包含 $25 的使用额度。

调用	价格
/v1/brief	$0.010
/v1/multi	$0.025
/v1/delta	$0.008（无变化时为 $0.001）
/v1/candles	$0.005
/v1/analogs	$0.050
/v1/scan	$0.020

实时数据：GET /v1/platforms。

法律声明

patternfetch 提供非个性化市场数据和算法信号，仅供参考。这不是投资、金融、法律或税务建议，也不构成买入、卖出或持有任何证券或加密资产的建议。输出内容并非针对您个人定制。基准比率是未计入止损、费用或滑点的总体方向性频率；过往表现和历史相似案例并不保证未来结果。市场波动剧烈，您可能损失全部资本。请自行研究。请参阅patternfetch.com/disclaimer、/methodology和/terms。