patternfetch
One call turns a crypto ticker + timeframe into a token-compact market-state brief — compact candles, detected chart/candlestick patterns, support/resistance, trend/regime, and interpreted indicators (RSI/EMA state) plus a one-line summary. So your AI agent never has to dump raw OHLCV into its context (saves tokens, avoids numeric hallucination).
Agent-first API + MCP. Crypto spot, minute-to-daily. Pay per call via x402 (USDC on Base, no account) or Stripe. Impersonal market data — not investment advice.
Why it's smaller: for BTC/USDT 4h (120 candles), a raw OHLCV dump is ~3,260 tokens of just numbers the model still has to analyze; patternfetch's interpreted analysis is ~1,323 tokens, already decided. Reproduce it (no account needed).
Install
npm install patternfetch
Quickstart
import { Patternfetch } from 'patternfetch';
// free key (small free credit included)
const { key } = await new Patternfetch().createKey('you@example.com');
const pf = new Patternfetch({ apiKey: key });
const brief = await pf.brief({ ticker: 'BTC/USDT', timeframe: '4h' });
console.log(brief.analysis.nl);
// "BTC/USDT: uptrend (strong), +2.1% last 4h, RSI 68 (neutral), bullish_engulfing (conf 1)."
console.log(brief.analysis.patterns, brief.analysis.levels, brief.analysis.regime);
Or with curl:
curl -X POST https://patternfetch.com/v1/keys -d '{"email":"you@example.com"}'
curl -X POST https://patternfetch.com/v1/brief \
-H "authorization: Bearer pf_..." \
-d '{"ticker":"BTC/USDT","timeframe":"4h"}'
Methods
| Method | Endpoint | What |
|---|---|---|
brief({ticker, timeframe, limit?, fields?}) | POST /v1/brief | Full market-state brief |
delta({ticker, timeframe}) | POST /v1/delta | Only what changed since your last brief (token-minimal polling) |
candles({ticker, timeframe}) | POST /v1/candles | Compact candle codec (rows + SAX) |
analogs({ticker, timeframe, window?, horizon?}) | POST /v1/analogs | Historical analogs as a full outcome distribution |
platforms() | GET /v1/platforms | Capabilities |
createKey(email) | POST /v1/keys | Self-serve key + free credit |
MCP
patternfetch is a remote MCP server (Streamable HTTP) at https://patternfetch.com/mcp.
Tools: patternfetch_brief, patternfetch_delta, patternfetch_analogs, patternfetch_capabilities.
Discovery (initialize, tools/list) is free — no key. Only tools/call needs auth.
One-click OAuth (nothing to paste) — in Claude Code, Claude Desktop, Cursor or Smithery, add the URL and authorize once; a free-tier key is minted for you:
claude mcp add --transport http patternfetch https://patternfetch.com/mcp
In claude.ai: Customize → Connectors → Add custom connector → https://patternfetch.com/mcp → Authorize.
Or with a Bearer key — add to your MCP config:
{
"mcpServers": {
"patternfetch": {
"url": "https://patternfetch.com/mcp",
"headers": { "Authorization": "Bearer pf_..." }
}
}
}
Get a free key (small starter credit) at https://patternfetch.com/v1/keys.
Local stdio bridge
Prefer a local stdio server (Claude Desktop, sandboxes, no inbound HTTP)? This package
ships patternfetch-mcp, a zero-dependency stdio↔HTTP bridge that exposes the same tools
and forwards calls to patternfetch.com:
{
"mcpServers": {
"patternfetch": {
"command": "npx",
"args": ["-y", "patternfetch-mcp"],
"env": { "PATTERNFETCH_API_KEY": "pf_..." }
}
}
}
tools/list works with no key; tool calls use PATTERNFETCH_API_KEY (or x402). Override the
endpoint with PATTERNFETCH_MCP_URL.
Legal
patternfetch provides impersonal market data and algorithmic signals for informational purposes only. NOT investment, financial, legal or tax advice and not a recommendation to buy, sell or hold any crypto-asset. Outputs are not personalized to you. Past performance and historical analogs do not guarantee future results. Crypto-assets are highly volatile — you may lose all capital. Do your own research. See patternfetch.com/disclaimer and /terms.