TILLA
TILLA DOCS · GETTING STARTED

Rate limits, tiers & speed

The table below is read from GET /v1/tiers on the live API every time this page loads, so it is always what the API enforces.

Loading the live tier table…

What every tier holds, cadence by cadence — the number of series a key of that tier is granted on each lane, measured from the tier manifest the API enforces (2026-10-14). Plans are nested: a higher tier holds everything below it.

Layer · laneFreeBuilderProMaxEnterprise
raw · 1min10615730916916
raw · 5min––626363
raw · 30min11161818
raw · hour126821,0251,2051,205
raw · daily133809381,1871,187
raw · weekly––323333
raw · monthly––151515
raw · quarterly––222
derived · 1min, 5min, 10min, 15min, 30min (each)––17,76521,54721,547
derived · 1hour, 4hour, 8hour (each)50 (1hour)18,43123,92927,56127,566
derived · daily508,36918,64624,36624,381
derived · weekly–8,20118,08023,50423,519
derived · 30day, monthly (each)–5,93513,26317,03517,050
derived · quarterly–2,1386,0958,1918,203
node · 10min, 30min, hour (raw, each)–––5858
node · 1hour … quarterly (derived)–––755 – 2,021 a lane755 – 2,021 a lane
deep · hour (back to 2002 / 2017 / 2020)11566712892892
distinct fields10820,22431,56241,92141,921
series (field × lane)147163,800233,491298,429298,516

What is counted, per key:

LimitOver it
Requests per minute429 with Retry-After
Requests per day429
Rows per day429
Distinct tables touched per day429
200 series in one request413 — split the list
50,000 rows in one request413 — page with next_start, or use export

Every keyed answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (the minute, reset in seconds), plus X-RateLimit-Limit-Day and X-RateLimit-Remaining-Day. GET /v1/usage shows the whole budget at once.

History. Each tier sets how far back a key may read, and a paid key reads its tier's whole window from the day it is made. A start older than your floor is clipped, not refused: the answer says X-Tilla-Clipped: 1, and X-Tilla-Floor names your first readable bar. The newest bar is never held back on any tier. The deep hourly history (/deep/hour) has no floor on any tier.

Speed — measured through the public URL

Small reads answer in about 0.07 s (median) over the public internet. Under 15 minutes of all three paid keys calling at once, 99% of answers came back within 0.20–0.28 s (measured 2026-10-13). Bulk files download at the speed of the link — 12 MB/s measured for the whole Max set.