<!-- mcp-name: io.github.MarvinRey7879/patternfetch -->

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.

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 also an MCP server. Tools: patternfetch_brief, patternfetch_delta, patternfetch_analogs, patternfetch_capabilities.

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

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.