Market-state brief · API + MCP

Stocks, ETFs & crypto, read as market state — not a wall of candles.

patternfetch turns any ticker and timeframe into a token-compact brief: regime, support & resistance, interpreted indicators, and chart patterns that ship with a backtested base rate and a 95% confidence interval. Your model reasons over a market read — a few hundred tokens, not 400,000 of raw OHLCV — and it knows when a "signal" is really a coin flip.

StocksETFsCrypto1m → 1wBinance + Yahoo
Signal vs. noise

Three textbook patterns. Three markets. Three honest base rates.

Each shape scored a geometric 1.00 — picture-perfect. Here is how often it actually resolved in its own direction, historically, over the next 10 bars — and how far that really lands from a coin flip.

the 50% line = a coin flip
distance from it = the honest edge
AAPL · 1d
bearish engulfing
shape 1.00
US stocks & ETFs
41.3%±0.9%n=12799
Below 50
SPY · 1d
double bottom
shape 1.00
US stocks & ETFs
57.1%±1.2%n=6700
Slight edge
BTC/USDT · 4h
bullish engulfing
shape 1.00
major crypto pairs
48.3%±2.3%n=1774
Coin flip

Directional hit rate over the next 10 bars, with a 95% confidence interval, measured with no lookahead — real /v1/demo output. Every competitor hands your model the shape score and stops. patternfetch hands it the evidence, so it weights a real edge — or the honest lack of one — instead of laundering a clean label into a confident, wrong call.

The proof

A real brief. AAPL, daily, right now.

This is a live /v1/demo response, rendered — the same JSON your model receives. No charting to squint at, no number-wall to hallucinate over: the market state is already digested into regime, levels, indicator state, and one plain-language line.

The moment that matters is the pattern block. A textbook bearish engulfing — geometric shape a perfect 1.00 — that historically resolved bearish just 41% of the time (±0.9%, across 12,799 occurrences in US stocks & ETFs). Below a coin flip: the bearish "signal" fades as equities drift up. The API says so, in the payload. That honesty is the moat.

Raw OHLCV dump
~400K
tokens · ≈ $6 / call
  • numbers the model miscounts
  • invented indicator values
patternfetch brief
~500
tokens · $0.01 / call
  • a read the model acts on
  • state, not arithmetic
AAPL· 1d
Yahoo · split & dividend adjusted · 120 bars
$308.63 ▲ 4.84% last 1d
codec: 44 of 120 candles shown — your model gets the compact rows + SAX shape "ddcdeecd", not the picture.
Regime
↑ Up
moderate · 0.63
RSI 14
60.28
neutral
Volatility
2.83%
ATR · EMA above 20 & 50

Resistance · strength

317.17
302.81
280.16

Support · strength

272.60
264.99
244.75
nl: "AAPL: uptrend (moderate), +4.84% last 1d, RSI 60.28 (neutral), bearish_engulfing (conf 1, n=2, hist 41% over 10b)."
bearish_engulfing geometric shape 1.00
41.3% ±0.9%
US stocks & ETFs horizon 10 bars n = 12799 CI 40.4–42.2% below 50 → bearish fades

Realizable gross directional base rate: the fraction of non-overlapping historical occurrences whose close-to-close return over the 10 bars after the pattern became knowable went its expected direction. No lookahead, no stop, fees or slippage. Not a prediction.

See it · 19 seconds

Digest, not dump.

A raw OHLCV response is hundreds of thousands of tokens your model miscounts. The same market, read as state, is a few hundred. Watch the wall of candles collapse into one honest brief.

Real /v1/brief output — ~400K raw OHLCV tokens digested into a ~500-token read your agent can act on.

Who it's for

Built for the desk and the agent.

One schema, two front doors. Read it yourself, or hand it to a model that pays for its own calls.

For traders

An honest market read on the tickers you actually watch.

Skip the chart-squinting and the indicator soup. Get the regime, the levels, and a plain-language line — plus a straight answer on whether a pattern means anything at all.

  • A one-line summary you can read in a glance — no number-walls.
  • Know when a "textbook" pattern is statistically just noise.
  • Stocks, ETFs and crypto — the same read across all of them.
  • No charting UI, no platform to learn. Just the state of the market.
Run it on your ticker
For AI agents

MCP-native. Five tools. Pays for its own calls.

Connect over MCP in one click — nothing to paste. Your agent gets a digested market state instead of a candle wall, and settles each call itself over x402.

  • Five MCP tools, one schema across every asset class.
  • x402 (USDC on Base) — ~$0.01 a call, no account, no card, no key.
  • ~800× fewer tokens than raw OHLCV — and no numeric hallucination.
  • One-click OAuth, or a Bearer key, or a local stdio bridge.
Connect over MCP
Capabilities

One schema. Every asset.

Everything below comes back from a single /v1/brief call — identical whether the ticker is a stock, an ETF or a crypto pair.

Patterns + base rate & CI

Chart and candlestick patterns with a geometric shape score and the backtested historical hit rate, a 95% confidence interval, and the sample size. The honest part: it flags a coin flip as a coin flip.

Support & resistance

Clustered swing levels with a 0–1 strength, so your model weights the wall it's actually near.

Trend & regime

Direction (up / down / range), a 0–1 strength, and volatility as ATR percent — the market's mood in one tile.

Interpreted indicators

RSI, EMA and ATR returned as state — "neutral", "above 20 & 50" — not a wall of decimals to miscount.

Multi-timeframe alignment

One /v1/multi call reads 1m → 1w together and tells you where the timeframes agree — and where they don't.

Historical analogs

Similar past windows returned as a full outcome distribution — winners and losers, mean and median. Not a prediction.

Compact candles

A token-efficient OHLCV codec plus a SAX shape fingerprint — the whole series, a fraction of the tokens.

Delta & one-line summary

Poll only what changed since your last brief, and read the whole state as a single natural-language line.

Flagship · the screener POST /v1/scan · $0.02

Turn lookup into discovery.

Every other endpoint answers about a ticker you already named. The screener flips it: scan US stocks, ETFs and crypto for the tickers currently in a given regime or printing a chart/candlestick pattern, ranked by the honest backtested base rate + 95% CI — so your model surfaces the few real signals instead of being handed one ticker at a time. Same honesty moat: a coin-flip pattern is flagged as a coin flip. Explore the screener →

Interface

Endpoints & MCP.

A small, honest REST surface — and the same tools over MCP for agents. Pay per call; the demo is free.

EndpointReturnsPrice
POST /v1/briefFull market-state brief$0.01
POST /v1/multiMulti-timeframe alignment (1m → 1w)$0.025
POST /v1/deltaOnly what changed since your last brief$0.008
POST /v1/candlesCompact candle codec + SAX shape$0.005
POST /v1/analogsHistorical analogs + outcome distribution$0.05
POST /v1/scanScreener — tickers by regime/pattern, ranked by base rate$0.02
POST /v1/demoNo-signup brief (rate-limited)free

Assets: US stocks, ETFs (Yahoo, adjusted) + crypto (Binance, realtime). Machine-readable OpenAPI · llms.txt · methodology.

Six MCP tools, one-click connect

Streamable HTTP at /mcp. Discovery (tools/list) is free — no key; a tools/call is billed like the REST route.

patternfetch_brief patternfetch_multi patternfetch_delta patternfetch_analogs patternfetch_scan patternfetch_capabilities
# one line — OAuth mints a free key, nothing to paste
claude mcp add --transport http \
  patternfetch https://patternfetch.com/mcp
{ "mcpServers": {
    "patternfetch": {
      "url": "https://patternfetch.com/mcp"
    } } }

Or let the agent pay as it goes. x402 settles ~$0.01 per call in USDC on Base — no account, no card, no key — discoverable at /.well-known/x402.json.

Pricing

Pay per call. Nothing to cancel.

No subscription, no seats. Start on a free no-signup demo or a free key with starter credit — and credits never expire.

Full pricing
/v1/demo
Free
no signup, rate-limited
/v1/brief
$0.01
full market-state brief
/v1/multi
$0.025
multi-timeframe
/v1/delta
$0.008
only what changed
/v1/candles
$0.005
compact codec
/v1/analogs
$0.05
outcome distribution
/v1/scan
$0.02
screener · discovery
Free key with starter credit Credits never expire Pay with x402 (USDC) or Stripe
Method & questions

Honest by construction.

Patterns, levels, regime and indicators are computed server-side from adjusted OHLCV. Base rates are measured with no lookahead — a chart pattern is scored only from the bar it becomes knowable. It is not a prediction and not a strategy backtest, and we say so in every payload.

Read the methodology
How accurate are the patterns?
Every pattern ships with a backtested base rate: how often that exact pattern, timeframe and confidence band historically resolved in its own direction over the next 10 bars — plus a 95% confidence interval and the sample size, measured with no lookahead. Most classic patterns land near a 50% coin flip over that horizon, and the number says so. Your model weights the evidence instead of trusting a confident-looking label.
Stocks and crypto in one API?
Yes — US stocks, ETFs and crypto return the same schema. Crypto comes from Binance in real time; stocks and ETFs from Yahoo, split- and dividend-adjusted. Timeframes: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w.
Do I need an account or API key?
No. There's a no-signup demo, and a free key with starter credit you mint in one call. Agents connect over MCP with one-click OAuth (a key is minted for you) or pay per call with x402 — no account at all.
What does a call cost?
Pay per call, no subscription: brief $0.01, multi $0.025, delta $0.008, candles $0.005, analogs $0.05. The demo is free and credits never expire.
Is this investment advice?
No. patternfetch is impersonal market data and algorithmic signals for informational purposes only — not investment, financial, legal or tax advice, not personalized, and not a recommendation to buy, sell or hold any asset.