Free API · v1
Free crypto data API
Token unlocks and how each one is known, a dated event calendar, the price move after every event, pattern base rates, and predictions with their record. Plain JSON files, no key, no sign-up, rebuilt every day.
The one rule
Show “Data: PatternPlus” linked to pattern.plus wherever you show or pass on the data. That's the whole price. Commercial use is fine: the data is CC BY 4.0.
<a href="https://pattern.plus">Data: PatternPlus</a>
The files
https://pattern.plus/api/v1/index.json- This list: every file and what it holds.
https://pattern.plus/api/v1/calendar.json- Every dated event in the next 90 days (token unlocks, exchange listings and delistings, DAO votes, network upgrades, Fed rate decisions, US CPI, jobs, PPI, PCE, GDP and retail sales releases, Bitcoin options expiries) and, where we count it, what past events like it did next.
https://pattern.plus/api/v1/unlocks.json- Token unlocks in the next 180 days, one row per coin and day: tokens, share of the circulating and total supply, value at today's price, and how we know it.
https://pattern.plus/api/v1/unlocks/{slug}.json- One coin's whole unlock schedule, past and future, row by row, with its sources (every coin listed with an unlocks file in tokens.json). 85 coins have one today.
https://pattern.plus/api/v1/predictions.json- Every current prediction: the likely range of a coin's move in 1, 7 and 30 days, the past cases behind it, the engine's chance it ends higher, and whether a call that earned it out of sample backs a direction (earned, with its record), and how often such calls were right.
https://pattern.plus/api/v1/calls.json- Today's calls that earned it out of sample, every coin and horizon (1, 7 and 30 days): the side (higher or lower, or stronger or weaker than the altcoin average), where the call comes from (a coin driver in play, the prediction's own band, or all our data combined: one model of everything we collect, a chance for every coin), its record (how often calls like it were right against that side on any day, on how many calls), the move on its side and the share liquidated at each leverage step, and for all our data combined the reasons behind its chance.
https://pattern.plus/api/v1/patterns.json- Every pattern we count: how many past events matched, how often the price was higher 1, 7, 30 and 90 days later, the median move, and whether the edge held up on newer cases.
https://pattern.plus/api/v1/effects.json- Every event of the last 365 days and the price move after it: 1, 7, 30 and 90 days, and against Bitcoin over 30 days.
https://pattern.plus/api/v1/tokens.json- Every coin on the site: name, ticker, rank, chain and contract, its page, and which files cover it.
https://pattern.plus/api/v1/scoreboard.json- Which kinds of event move price: each kind against the same coins' ordinary days, the share higher 1, 7 and 30 days later, counted by day, the edge in points with its 95% range and in each half of history, and the size of the move.
https://pattern.plus/api/v1/altseason.json- Our altcoin season index: of the 50 most traded coins (stablecoins, wrapped coins and Bitcoin left out), how many did better than Bitcoin over the last 90 days, out of 100 (75 or more an altcoin season, 25 or under a Bitcoin season), today and every week since 2018, with the page that tests what came after it.
https://pattern.plus/api/v1/mayer.json- Bitcoin's Mayer Multiple: its daily close over the average of its last 200 closes (1.00 on the average; 2.40 the line Trace Mayer called too hot, under 0.80 the deep bear markets), today and every week since 2017, with the page that tests what Bitcoin did after each level.
https://pattern.plus/api/v1/ethbtc.json- ETH/BTC: Ether's price in Bitcoin against the average of its last 200 days (1.00 on the average; under 0.80 far under it, 1.20 or more well over), today and every week since 2018, with the page that tests what Ether did against Bitcoin after each level.
https://pattern.plus/api/v1/cmegap.json- Bitcoin's CME gap: the newest weekend's gap between CME's Friday close and Sunday's open (on Binance's hourly price), its level and its mirror (as far from the open the other way) and when each was reached; how often past gaps of 0.5% or more were filled within 30 days beside their mirrors; every weekend since December 2017 with which level came first, with the page that tests it.
https://pattern.plus/api/v1/funding.json- Bitcoin's funding rate on Binance's BTCUSDT perpetual (what the longs pay the shorts every 8 hours, the shorts the longs under zero) as a year's rate: the newest whole day's, the last 7 days' and every week's since 2019 (the default, 0.01% every 8 hours, is about 11% a year), with the page that tests what Bitcoin did after each level.
https://pattern.plus/api/v1/kimchi.json- Bitcoin's Korean premium (the 'kimchi premium'): its close in won on Upbit, Korea's biggest exchange, over its dollar close at the same moment in won at the Fed's noon rate, less 1 (0.03 is 3%; a discount under zero), today and every week since 2017, with the page that tests what Bitcoin did 30 and 90 days after each level.
https://pattern.plus/api/v1/cot.json- Hedge funds (the CFTC's leveraged funds) in CME's Bitcoin futures: their net position in contracts (5 Bitcoin each) and as a share of the open interest, ranked against the year of reports before it (0 the most short of its year), every Tuesday's report since 2017, with the asset managers' net and the page that tests what Bitcoin did after each rank.
https://pattern.plus/api/v1/myths.json- Crypto sayings, tested (CME gaps always fill, Uptober, extreme fear, token unlocks dump the price, ...): each one's verdict tonight - true, false, not proven or no edge - read from the numbers of the standing study that tests it, those numbers in words, and the study.
https://pattern.plus/api/v1/indicators.json- Bitcoin's indicators today (the Mayer Multiple, the 200-week average, Fear & Greed, funding, RSI, the VIX, ...): each one's reading on the newest close, the band it falls in, and what came after the past days in that band against the other days over the next 90 days (30 for RSI), with the luck test's answer, from the standing study that reads it.
https://pattern.plus/api/v1/events/{kind}.json- Every measured past event of one kind and the price move after it (1, 7, 30 and 90 days), newest first; the kinds are the ones scoreboard.json lists.
https://pattern.plus/api/v1/coin/{slug}.json- One coin in one file: its dated events in the next 90 days with what past events like each did, and its current predictions (the embeddable card reads it).
Quick start
curl https://pattern.plus/api/v1/unlocks.json
const res = await fetch("https://pattern.plus/api/v1/calendar.json");
const {data, as_of} = await res.json(); // every event in the next 90 days, as of as_of
import requests
unlocks = requests.get("https://pattern.plus/api/v1/unlocks.json").json()["data"]
The whole API is described in OpenAPI 3.1 at https://pattern.plus/api/v1/openapi.json: import it into Postman or Insomnia, generate a client, or hand it to an AI agent as tools.
Put a coin's next events on your site
Two lines anywhere in a page show a coin's next dated events (unlocks, listings, votes, upgrades), what past events like each did, and its likely 7-day range, with a direction only where a call earned it out of sample. It reads the coin's file above, draws in its own box so your styles stay yours, sets no cookies and tracks nobody, and carries the attribution link for you. The plain link inside the box is what a reader without JavaScript sees, and the credit the licence asks for.
<div data-patternplus="arb-arbitrum"><a href="https://pattern.plus/token/arb-arbitrum">Arbitrum (ARB) unlocks and events</a> by PatternPlus</div>
<script src="https://pattern.plus/embed.js" async></script>
Use any coin's id from tokens.json. Add data-theme="light" or "dark" to fix the colours (it follows the reader's system otherwise) and data-max="5" to show more events.
Put the altcoin season index, Bitcoin's Mayer Multiple or ETH/BTC on your site
The same two lines show a live market reading instead: today's number, what it means, and its last year as a line, updated every day from altseason.json, mayer.json or ethbtc.json, with the link to the study that tests what came after it.
<div data-patternplus="index:altseason"><a href="https://pattern.plus/research/is-it-altcoin-season">Altcoin season index</a> by PatternPlus</div>
<div data-patternplus="index:mayer"><a href="https://pattern.plus/research/mayer-multiple-bitcoin-200-day-average">Bitcoin's Mayer Multiple</a> by PatternPlus</div>
<div data-patternplus="index:ethbtc"><a href="https://pattern.plus/research/eth-btc-ratio-is-ether-cheap-against-bitcoin">ETH/BTC against its 200-day average</a> by PatternPlus</div>
<script src="https://pattern.plus/embed.js" async></script>
Every file looks like this
- data: the rows. Everything else describes them.
- as_of: the date the data is about; rebuilt: when the file was made.
- attribution and license: the rule above, in every file.
- count: how many rows; version: 1 (new fields can appear; a field is never renamed or removed within v1).
- Moves and chances are fractions:
0.042is 4.2%. Fields namedpct_…are already percent:2.1is 2.1%. - Every unlock row says how we know it (basis): the project's own documents (checked by hand, or matched to the circulating supply history), on-chain vesting contracts (Sablier, Hedgey, UNCX, Team Finance, Streamflow, Jupiter Lock), or projected from the circulating supply's own regular steps.
From tonight's unlocks.json
{
"api": "PatternPlus API",
"version": 1,
"file": "unlocks",
"as_of": "2026-11-19",
"rebuilt": "2026-11-19T05:38:56+00:00",
"attribution": {
"text": "Data: PatternPlus",
"url": "https://pattern.plus",
"required": "Show \"Data: PatternPlus\" linked to https://pattern.plus wherever you show or pass on this data."
},
"license": {
"name": "CC BY 4.0",
"url": "https://creativecommons.org/licenses/by/4.0/"
},
"docs": "https://pattern.plus/developers",
"count": 340,
"data": [
{
"date": "2026-11-20",
"token": "well-moonwell",
"symbol": "WELL",
"name": "Moonwell",
"amount": 170534.62,
"pct_circulating": 0.0044,
"pct_total": 0.0034,
"value_usd": 231,
"categories": [
"Sablier vesting"
],
"types": [
"cliff"
],
"basis": [
"on-chain vesting (Sablier)"
],
"file": "https://pattern.plus/api/v1/unlocks/well-moonwell.json"
},
{
"date": "2026-11-22",
"token": "skr-seeker",
"symbol": "SKR",
"name": "Seeker",
"amount": 99997969.33,
"pct_circulating": 1.7544,
"pct_total": 1.0,
"value_usd": 966063,
"categories": [
"Projected monthly release"
],
"types": [
"cliff"
],
"basis": [
"projected from the circulating supply's own regular steps"
],
"file": "https://pattern.plus/api/v1/unlocks/skr-seeker.json"
}
]
}
From tonight's calendar.json
{
"api": "PatternPlus API",
"version": 1,
"file": "calendar",
"as_of": "2026-11-19",
"rebuilt": "2026-11-19T05:38:56+00:00",
"attribution": {
"text": "Data: PatternPlus",
"url": "https://pattern.plus",
"required": "Show \"Data: PatternPlus\" linked to https://pattern.plus wherever you show or pass on this data."
},
"license": {
"name": "CC BY 4.0",
"url": "https://creativecommons.org/licenses/by/4.0/"
},
"docs": "https://pattern.plus/developers",
"count": 194,
"data": [
{
"date": "2026-11-20",
"kind": "unlock",
"token": "well-moonwell",
"symbol": "WELL",
"name": "Moonwell",
"title": "0.0% of supply unlocks",
"venue": null,
"page": "https://pattern.plus/token/well-moonwell",
"amount": 170534.62,
"pct_circulating": 0.0044,
"value_usd": 231,
"categories": [
"Sablier vesting"
],
"basis": [
"on-chain vesting (Sablier)"
]
},
{
"date": "2026-11-20",
"kind": "vote",
"token": "aave-aave",
"symbol": "AAVE",
"name": "Aave",
"title": "[ARFC] Dynamic Caps Oracle: Rate Limiter",
"venue": null,
"page": "https://pattern.plus/token/aave-aave",
"past_events_like_it": {
"pattern": "vote-cap-mid-cat-l1-l2",
"horizons": {
"1d": {
"higher": 0.5127,
"ci90": [
0.4777,
0.5476
],
"median_move": 0.0021,
"n": 550
},
"7d": {
"higher": 0.4718,
"ci90": [
0.4369,
0.5069
],
"median_move": -0.0084,
"n": 549
},
"30d": {
"higher": 0.4497,
"ci90": [
0.4151,
0.4849
],
"median_move": -0.0257,
"n": 547
},
"90d": {
"higher": 0.4642,
"ci90": [
0.4293,
0.4994
],
"median_move": -0.0359,
"n": 545
}
},
"page": "https://pattern.plus/pattern/vote-cap-mid-cat-l1-l2"
}
}
]
}
From tonight's calls.json
{
"api": "PatternPlus API",
"version": 1,
"file": "calls",
"as_of": "2026-11-19",
"rebuilt": "2026-11-19T05:38:56+00:00",
"attribution": {
"text": "Data: PatternPlus",
"url": "https://pattern.plus",
"required": "Show \"Data: PatternPlus\" linked to https://pattern.plus wherever you show or pass on this data."
},
"license": {
"name": "CC BY 4.0",
"url": "https://creativecommons.org/licenses/by/4.0/"
},
"docs": "https://pattern.plus/developers",
"count": 270,
"data": [
{
"token": "ir-infrared",
"symbol": "IR",
"name": "Infrared",
"horizon": "1d",
"side": "down",
"word": "lower",
"relative": false,
"conflict": false,
"source": "model",
"p": 0.256,
"page": "https://pattern.plus/token/ir-infrared",
"record": {
"side": "down",
"source": "model",
"kind": "abs1_strong",
"tier": null,
"target": "abs1",
"band": "strong",
"calls": 52743,
"days": 2654,
"hit": 0.6176,
"same": 0.5285,
"same0": 0.5316,
"edge": 0.1075,
"t": 21.7832,
"first_call": "2018-11-19",
"last_call": "2026-11-17",
"verdict": "DIRECTION EDGE",
"updated": "2026-11-19",
"mean_move": 0.0071,
"median_move": 0.02,
"p10_move": -0.1137,
"p90_move": 0.1254,
"move_older": 0.0085,
"move_newer": 0.0067,
"liq": {
"2": 0.0331,
"3": 0.0675,
"4": 0.1121,
"5": 0.1566,
"6": 0.1996,
"7": 0.2393,
"8": 0.2781,
"9": 0.314,
"10": 0.3467,
"12": 0.4077,
"15": 0.4857,
"20": 0.5829
},
"why": [
{
"feature": "ret_1",
"text": "up 90% over the last day"
},
{
"feature": "ret_3",
"text": "up 70% over the last 3 days"
},
{
"feature": "pat_vol_spike",
"text": "a volume spike (at least 5x its 30-day median) at its last close"
}
]
}
},
{
"token": "zkc-boundless",
"symbol": "ZKC",
"name": "Boundless",
"horizon": "1d",
"side": "down",
"word": "lower",
"relative": false,
"conflict": false,
"source": "model",
"p": 0.2573,
"page": "https://pattern.plus/token/zkc-boundless",
"record": {
"side": "down",
"source": "model",
"kind": "abs1_strong",
"tier": null,
"target": "abs1",
"band": "strong",
"calls": 52743,
"days": 2654,
"hit": 0.6176,
"same": 0.5285,
"same0": 0.5316,
"edge": 0.1075,
"t": 21.7832,
"first_call": "2018-11-19",
"last_call": "2026-11-17",
"verdict": "DIRECTION EDGE",
"updated": "2026-11-19",
"mean_move": 0.0071,
"median_move": 0.02,
"p10_move": -0.1137,
"p90_move": 0.1254,
"move_older": 0.0085,
"move_newer": 0.0067,
"liq": {
"2": 0.0331,
"3": 0.0675,
"4": 0.1121,
"5": 0.1566,
"6": 0.1996,
"7": 0.2393,
"8": 0.2781,
"9": 0.314,
"10": 0.3467,
"12": 0.4077,
"15": 0.4857,
"20": 0.5829
},
"why": [
{
"feature": "ret_1",
"text": "up 26% over the last day"
},
{
"feature": "funding",
"text": "Binance funding of -11.80% over the last 7 days"
},
{
"feature": "pat_vol_spike",
"text": "a volume spike (at least 5x its 30-day median) at its last close"
}
]
}
}
]
}
Good to know
- The files change once a day, around 04:00 UTC. Cache them; calling more often returns the same file.
- They're served from Cloudflare's edge, and any website can read them from the browser (CORS is open).
- Predictions say what past patterns did next. They're not financial advice and they can stop working;
predictions.jsoncarries their record so you can judge them. - Need live prices, alerts or webhooks? That's coming with Pro.