What happened the last time a chart looked like this?

ChartMatch scans millions of historical candles across crypto, stocks, forex, commodities, and indices to find the closest pattern matches then shows you exactly what happened next.

TRXUSDT · Feb – Mar 2026
96.6%
similar
PAXGUSDT · Mar 2024
What happened next: +7.0% in 30 days · 7 of 10 matches bullish
10M+
Candles scanned
500+
Instruments
6
Asset classes
Daily
Synced
How it works

Three steps to historical context

One API call. Structured results. No data pipeline to maintain.

1

Pick any symbol

BTCUSDT, AAPL, Gold, EUR/USD any of 500+ instruments across crypto, stocks, forex, commodities, indices, and ETFs.

2

We scan every window

Dynamic Time Warping compares your chart's recent shape against millions of historical candle windows to find the closest matches.

3

See what happened next

Each match shows 7-day, 14-day, and 30-day outcomes with confidence scores, volatility context, and consensus direction across all matches.

What you get back

Every match, fully contextualized

Every result tells you what happened next, how confident the match is, and what the consensus says.

10 pattern matches found just now
SOLUSDT SAME CLASS
97.2% match
matched AVAXUSDT · Nov 8 – Dec 7, 2023
query historical match
what happened next
+22.4%
in 30 days
8 of 10 matches bullish
AAPL MSFT · Aug 2022 SAME CLASS 95.8% +11.7%
ETHUSDT BTCUSDT · Mar 2024 SAME CLASS 93.1% -4.2%
See the raw API response →
POST /v1/similar-patterns
curl -X POST /v1/similar-patterns \
  -H "X-API-Key: cm_your_key" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"BTCUSDT","lookback":30,"top_n":10}'
response (match #1 of 10)
{
  "symbol": "BTCUSDT",
  "relevance": "same_pair",
  "similarity": 0.9487,
  "confidence": "top 0.003%",
  "volatility_ratio": 1.12,
  "volatility_context": "normal",
  "period": "2024-03-12 → 2024-04-10",
  "outcome": {
    "return": "+15.21%",
    "max_gain": "+18.40%",
    "max_drawdown": "-3.12%",
    "direction": "bullish"
  },
  "outcome_summary": {
    "consensus": "7 of 10 bullish (70%)",
    "avg_return": "+8.73%"
  }
}
Cross-Asset Discovery

Same-asset history is just the start

When your BTC chart matches Gold from 2019 and the S&P 500 from 2022, that's an insight you can't find by looking at one asset in isolation.

BTCUSDT BTCUSDT (Mar 2024)
SAME PAIR All plans
BTCUSDT ETHUSDT (Jan 2024)
SAME CLASS Pro
BTCUSDT GC=F Gold (Nov 2019)
CROSS-ASSET Pro
BTCUSDT ^GSPC S&P 500 (Aug 2022)
CROSS-ASSET Pro
Data

One database. Six asset classes.

All instruments synced daily from Binance and Yahoo Finance. 13+ years of daily data.

CRYPTO
370+ pairs · Binance
FOREX
25 pairs · EUR, GBP, JPY…
COMMODITIES
26 futures · Gold, Oil, Coffee…
INDICES
24 global · S&P, NASDAQ, DAX…
ETFs
30 funds · SPY, QQQ, GLD…
STOCKS
150+ equities · AAPL, NVDA, TSLA…
Built for Traders

Every field you need to make a decision

Each result includes the full context. Not just similarity, but confidence, volatility, outcomes, and consensus.

Confidence Percentile

Each match shows top percentage. "top 0.003%" match beats 99.997% of all 10M+ windows searched. So you know if 0.93 is exceptional or ordinary.

"confidence": "top 0.003%"

Directional Consensus

Across all matches: "7 of 10 bullish, 3 of 10 bearish." The single number a trader checks first before examining individual matches.

"direction": "bullish" · "consensus": "70%"

Multi-Timeframe Outcomes

Every match shows 7-day, 14-day, and 30-day returns with max gain and max drawdown. A pattern can be bullish at 7d but bearish at 30d.

"7d": +3.2% · "14d": +7.4% · "30d": -1.8%

Volatility Context

A 10% move means different things for different assets. Each match shows a volatility ratio. 1.0x is normal, 2.5x means crisis-level.

"volatility_ratio": 1.85 · "context": "elevated"

Volatility Filtering

Search only for patterns that formed during calm or high-volatility periods. Filter with min_volatility and max_volatility.

"min_volatility": 0.3, "max_volatility": 0.8

Relevance Filter Modes

Default returns the top-N by similarity. Or filter to same_pair, same_asset_class, cross_asset, or balanced.

"relevance_filter": "balanced"
Try it now

Interactive web terminal

Search any instrument, see pattern matches with full charts, and explore outcomes right in your browser. No API key needed to try.

ChartMatch web terminal showing BTCUSDT pattern matches with candlestick chart, outcome summary, and relevance filters
Open the Terminal → Read the docs
REST API

One call. Structured results.

Send a symbol and a lookback window. Get back ranked pattern matches with similarity scores, confidence percentiles, outcomes, and consensus. All as clean JSON.

POST /v1/similar-patterns
request
curl -X POST /v1/similar-patterns \
  -H "X-API-Key: cm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol":   "BTCUSDT",
    "lookback": 30,
    "top_n":    10
  }'
Response · match #1 of 10
response
{
  "symbol": "BTCUSDT",
  "relevance": "same_pair",
  "similarity": 0.9487,
  "confidence": "top 0.003%",
  "volatility_ratio": 1.12,
  "period": "2024-03-12 → 2024-04-10",
  "outcome": {
    "return": "+15.21%",
    "max_gain": "+18.40%",
    "max_drawdown": "-3.12%",
    "direction": "bullish"
  },
  "outcome_summary": {
    "consensus": "7/10 bullish (70%)",
    "avg_return": "+8.73%"
  }
}
Full API Docs → Get your API key
Pricing

Simple, transparent pricing

All plans include outcome data, confidence scores, and multi-timeframe breakdowns.

Free

$0
5 calls / month
  • Top crypto pairs
  • Pattern matching + DTW
  • Outcome data & win rates
  • Confidence scores
  • Multi-timeframe breakdowns
  • Cross-asset search
  • Relevance tiers
Get started

Builder

$49.99/mo
30,000 calls / month
  • Everything in Pro
  • High-volume access
  • Bulk pattern analysis
Start Builder
Use Cases

Built for every trading workflow

From manual lookups to fully automated pipelines.

💹

Active Traders

Get a second opinion on any chart setup. See how similar patterns played out historically before placing a trade.

  • Look up any symbol in the terminal
  • Check directional consensus at a glance
  • See 7d, 14d, 30d outcome distributions
📈

Algo Traders

Integrate pattern insights directly into your strategy pipeline via the REST API.

  • Automate entry pattern detection
  • Filter by relevance tier
  • Combine with your own indicators
🔬

Quant Researchers

Query multi-asset historical outcomes at scale. DTW finds shape-similar patterns even when time-compressed or stretched.

  • Cross-asset correlation discovery
  • Volatility-regime filtering
  • Bulk pattern search for backtests
🛠️

Tool Builders

Embed pattern intelligence into your dashboard, Telegram bot, or TradingView script.

  • RESTful JSON. Drop into any stack
  • Simple API key auth
  • No data pipeline to maintain
FAQ

Common questions

What traders ask before they sign up.

Does a high-similarity past pattern predict the future?
No and we're honest about that. Pattern matching is a research tool, not a fortune teller. What it gives you is base rates: across similar past setups, X% resolved bullishly at 30 days, with an average return of Y%. You weight that data alongside everything else in your process.
What does "similarity score" actually mean?
It's a normalized DTW distance. 1.0 means a perfect shape match, 0.0 means completely dissimilar. We also show a confidence percentile ("top 0.003%") so you know if 0.93 is exceptional for that query or just average.
How often is the data updated?
The database syncs daily. Crypto pairs are pulled from Binance; forex, commodities, indices, ETFs, and stocks come from Yahoo Finance. The /health endpoint shows the last sync timestamp.
Can I search across asset classes like finding BTC patterns in gold?
Yes. Cross-asset search is available on Pro and Builder plans. Matches are tagged with a relevance tier (same_pair, same_asset_class, or cross_asset) so you always know the type of match you're looking at.

See what the chart says.

5 free API calls per month. No credit card required. Upgrade when you need more.

Get started free → Read the docs

Disclaimer

ChartMatch provides historical data analysis for educational and research purposes only. It does not constitute financial advice, investment recommendations, or trading signals. Past patterns do not guarantee future results.

Click anywhere to continue