# patternfetch

> Agent-first API + MCP. One call turns a crypto ticker + timeframe into a token-compact
> market-state brief: compact candles, detected patterns, support/resistance, trend/regime,
> and interpreted indicators — so an LLM agent never has to dump raw OHLCV into its context.
> Impersonal market data, NOT investment advice.

## What it does
- POST /v1/brief   {ticker, timeframe} -> compact market-state brief (candles + patterns + S/R + regime + indicators + 1-line summary)
- POST /v1/delta   {ticker, timeframe} -> only what changed since your last brief (token-minimal for polling)
- POST /v1/candles {ticker, timeframe} -> compact candle codec only (rows + SAX shape signature)
- POST /v1/analogs {ticker, timeframe} -> historical analogs as a FULL outcome distribution (n, win-rate, median, min, max). Not a prediction.
- POST /v1/keys    {email} -> self-serve API key + free credit
- GET  /v1/platforms -> capabilities (assets, timeframes, endpoints)
- GET  /healthz

## Auth & payment
- Bearer API key (POST /v1/keys to get one, free credit included).
- Pay per call via x402 (USDC on Base, no account) or Stripe (cards).

## MCP
- Tools: patternfetch_brief, patternfetch_delta, patternfetch_analogs, patternfetch_capabilities.

## Legal
- Impersonal, informational only, not advice, not personalized, non-executing. Crypto spot only.
- See /disclaimer and /terms.