patternfetch — Market-State Briefs for AI Trading Agents

What is patternfetch?

patternfetch is an MCP server that turns a crypto ticker and timeframe into a token-compact market-state brief for LLM trading agents. It replaces raw OHLCV data with compact candles, SAX shape signatures, detected chart and candlestick patterns, support/resistance clusters, regime labels, and interpreted indicators (RSI/EMA/ATR), plus a one-line summary. Crypto-first and impersonal — it provides data, not buy/sell advice.

How to use patternfetch?

Configure the MCP client as a remote streamable-http server using the URL https://patternfetch.com/mcp and an Authorization header with a Bearer token. Obtain an API key by sending a POST request to /v1/keys with your email. Then send ticker and timeframe parameters to endpoints like /v1/brief to retrieve a full brief, or use /v1/delta for token-minimal polling.

Key features of patternfetch

• Compact candle codec with SAX shape signature per ticker
• Detected chart patterns (double top/bottom, head & shoulders, engulfing, hammer, doji)
• Support/resistance clusters and market regime labels
• Interpreted indicators (RSI, EMA, ATR) with a one-line summary
• Token-minimal polling via /v1/delta endpoint (cheaper if unchanged)
• Pay-per-call via x402 (USDC on Base) or Stripe

Use cases of patternfetch

• AI trading agents needing structured market-state briefs without raw OHLCV
• Token-constrained LLM context optimization for multi-ticker analysis
• Efficient polling of price state changes using delta updates
• Historical outcome distribution for backtesting via /v1/analogs

FAQ from patternfetch

What are the different endpoints and their costs?

/v1/brief ($0.01) returns the full brief; /v1/delta ($0.008, $0.001 if unchanged) returns only changes from the last brief; /v1/candles ($0.005) returns only compact candles; /v1/analogs ($0.05) returns historical analog outcomes; /v1/keys (free) provides a key with $0.05 credit.

How do I pay for calls?

Payment is per call via x402 (USDC on Base, no account required) or Stripe credit cards. Every response includes an exact cost block.

Is patternfetch investment advice?

No. It provides impersonal market data only. The server is non-directive by design — it never gives buy/sell advice.

How do I get an API key?

Send a POST to https://patternfetch.com/v1/keys with a JSON body containing your email (e.g., {"email":"[email protected]"}). You will receive a key to use in the Authorization header.

What assets and timeframes are supported?

The /v1/platforms endpoint returns a free capability matrix listing all supported assets (crypto tickers) and available timeframes.