{"openapi":"3.0.3","info":{"title":"TILLA Data API","version":"3.0","description":"Three years of market datapoints and derived series, hashed as they land."},"servers":[{"url":"https://api.tillacrypto.com"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"paths":{"/":{"get":{"summary":"this index - endpoints, auth, formats, tiers","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1":{"get":{"summary":"the same index","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/":{"get":{"summary":"the same index","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/ping":{"get":{"summary":"liveness check","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/tiers":{"get":{"summary":"tier catalog: price, history, limits, the hook","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/status":{"get":{"summary":"the newest 1min label and the tiers served","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/health":{"get":{"summary":"the newest label of every lane, every layer","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/calls":{"get":{"summary":"EVERY CALL, READY TO PASTE: method, URL for ?tier=, auth, what it returns, and every error - ?format=json|csv (a sheet)","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"query","required":false,"schema":{"type":"string","default":"free","title":"Tier"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}]}},"/v1/{tier}/calls":{"get":{"summary":"everything your tier can do: every call with its ready URL (json, or ?format=csv)","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}]}},"/v1/samples":{"get":{"summary":"the free samples of every tier, no key","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/sample/{name}":{"get":{"summary":"one tick of everything a tier holds: {tier}.db (SQLite), {tier}.csv (a sheet), {tier} (JSON at a glance)","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/inventory":{"get":{"summary":"what your tier holds (?layer=&lane=; ?tier= previews a lower tier)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"layer","in":"query","required":false,"schema":{"type":"string","title":"Layer"}},{"name":"lane","in":"query","required":false,"schema":{"type":"string","title":"Lane"}},{"name":"tier","in":"query","required":false,"schema":{"type":"string","title":"Tier"}}]}},"/v1/usage":{"get":{"summary":"your plan and your budgets right now","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/{tier}/raw/{lane}":{"get":{"summary":"raw window: ?series=a,b&start=&end=&limit=&format=json|csv|ndjson|parquet","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/derived/{lane}":{"get":{"summary":"derived window, the same parameters","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/node/{lane}":{"get":{"summary":"the node (max and above), the same parameters","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/deep/{lane}":{"get":{"summary":"THE DEEP HISTORY, lane hour: hourly raw prices from each market's first bar (FX 2002, crypto 2017, US stocks 2020) to 2023-08-10, no history floor; the same series names and parameters as raw/hour","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/export/{layer}/{lane}":{"get":{"summary":"BULK: the whole window in one streamed request, csv|ndjson|parquet, hashed and recorded (pro and above)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"layer","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"csv","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/tick":{"get":{"summary":"TICK: every series your key is sold, on every clock lane that closed at a boundary, in ONE answer (?at=YYYY-MM-DD HH:MM, default the minute just closed; ?lanes=raw/1min,derived/5min to ask again for lanes still writing). Ask once a minute and you have the whole tier, live","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"at","in":"query","required":false,"schema":{"type":"string","title":"At"}},{"name":"lanes","in":"query","required":false,"schema":{"type":"string","title":"Lanes"}},{"name":"wait","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Wait"}}]}},"/v1/{tier}/changes":{"get":{"summary":"CHANGES: every cell the base repaired, filled or re-walked since ?since= (its hourly audit, 2-hourly sweep and heal, day close, derived rewinds) that your key holds, with its value now - apply them and your copy heals when ours does; pass `until` back as the next since","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","title":"Since"}}]}},"/v1/{tier}/resume/{layer}/{lane}":{"get":{"summary":"RESUME: every series your key is sold on one lane, every bar from ?since= to now, streamed in one request (ndjson|csv|parquet) - fill the gap since you last stopped, then tick","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"layer","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","title":"Since"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"ndjson","title":"Format"}}]}},"/v1/markets":{"get":{"summary":"every main market: its category, its related markets, how many series each tier holds of it, its lanes, and its call","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/{tier}/market/{subject}":{"get":{"summary":"ONE MARKET and everything of it your tier holds, on one clock: ?lane=1min&layer=raw|derived|all&related=1 (its ETFs, miners, sister pairs ...)&period=6m; 200 columns an answer, ?offset= walks the rest","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"subject","in":"path","required":true,"schema":{"type":"string"}},{"name":"lane","in":"query","required":false,"schema":{"type":"string","default":"1min","title":"Lane"}},{"name":"layer","in":"query","required":false,"schema":{"type":"string","default":"raw","title":"Layer"}},{"name":"related","in":"query","required":false,"schema":{"type":"string","title":"Related"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","title":"Period"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","title":"Fields"}}]}},"/v1/{tier}/bulk":{"get":{"summary":"BULK: your whole window straight from the database - every lane your tier holds, each with its resume url (Parquet, csv or ndjson, streamed); ?markets=crypto|stocks|fx|macro|<ids> narrows it to those markets","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"layer","in":"query","required":false,"schema":{"type":"string","title":"Layer"}},{"name":"lane","in":"query","required":false,"schema":{"type":"string","title":"Lane"}},{"name":"after","in":"query","required":false,"schema":{"type":"string","title":"After"}},{"name":"markets","in":"query","required":false,"schema":{"type":"string","title":"Markets"}}]}},"/v1/{tier}/bulk/file/{sha}":{"get":{"summary":"a prebuilt Parquet file by its sha256 - none are published today (404); take the resume urls /bulk lists","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"sha","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/{tier}/stream":{"get":{"summary":"LIVE: finished bars as they land, SSE (?layer=&lanes=&series=&since=; Last-Event-ID replays)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"tier","in":"path","required":true,"schema":{"type":"string"}},{"name":"layer","in":"query","required":false,"schema":{"type":"string","default":"raw","title":"Layer"}},{"name":"lanes","in":"query","required":false,"schema":{"type":"string","default":"1min","title":"Lanes"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"since","in":"query","required":false,"schema":{"type":"string","title":"Since"}}]}},"/v1/data":{"get":{"summary":"legacy, kept for existing scripts - use /v1/{tier}/raw/{lane}: ?series= (or cols=)&start=&end=&limit=&format=&table=","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"cols","in":"query","required":false,"schema":{"type":"string","title":"Cols"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"start","in":"query","required":false,"schema":{"type":"string","title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","title":"End"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":1440,"title":"Limit"}},{"name":"table","in":"query","required":false,"schema":{"type":"string","default":"crypto_1min","title":"Table"}}]}},"/v1/latest":{"get":{"summary":"legacy, kept for existing scripts - use /v1/{tier}/tick: the newest row of ?series= (or cols=) at ?table=","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"cols","in":"query","required":false,"schema":{"type":"string","title":"Cols"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"table","in":"query","required":false,"schema":{"type":"string","default":"crypto_1min","title":"Table"}}]}},"/v1/sync":{"get":{"summary":"legacy, kept for existing scripts - use /v1/{tier}/resume/{layer}/{lane}: everything from ?since=, paged with next_start","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}},"parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","title":"Since"}},{"name":"cols","in":"query","required":false,"schema":{"type":"string","title":"Cols"}},{"name":"series","in":"query","required":false,"schema":{"type":"string","title":"Series"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5000,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"table","in":"query","required":false,"schema":{"type":"string","default":"crypto_1min","title":"Table"}}]}},"/v1/demo_key":{"post":{"summary":"a free key, no account, one per address per day","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/free_key":{"post":{"summary":"self-serve free key (signed-in session)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/my_key":{"post":{"summary":"your key; ?peek=1 check without minting, ?rotate=1 replace, ?claim=1 show a just-bought key once","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/checkout":{"post":{"summary":"start a subscription (or the portal if already paid)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/portal":{"post":{"summary":"Stripe billing portal (manage / cancel)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/enterprise_inquiry":{"post":{"summary":"an enterprise lead","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/contact":{"post":{"summary":"a support ticket: name, email, topic, message - it reaches the founder inbox","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}},"/v1/stripe_webhook":{"post":{"summary":"Stripe events (signature-verified)","security":[],"responses":{"200":{"description":"OK"},"401":{"description":"missing API key"},"403":{"description":"refused"},"429":{"description":"rate limit / quota"}}}}}}