TILLA
TILLA DOCS · DATA REFERENCE

Tables, coverage & calendar

Field names here are the literal names you pass to series= and receive back in series. The full list, searchable, is in the Data catalog; the exact set per plan is under Plans, and GET /v1/inventory lists exactly what your key holds.

Tables & cadences

Raw lives in tables — one per asset class and cadence. You never have to name a table: ask for series by name on the lane you want and the API finds them. GET /v1/inventory?layer=raw&lane=1min shows your series grouped by table. Every field's detail row in the Data catalog shows the table each of its datapoints lives in.

TableCadenceDatapointsMostly
crypto_1min1min415Crypto spot, Bitcoin node, On-chain network
forex_1min1min264FX
equities_1min1min237US equities & ETFs
crypto_5min5min63Perpetuals & funding, Options & volatility, On-chain network
block_10min10min58Bitcoin node
block_30min30min58Bitcoin node
crypto_30min30min18Market structure & DeFi, Crypto spot, Options & volatility
crypto_1hhour494Crypto spot, Perpetuals & funding, Options & volatility
forex_1hhour268FX, Global indices & commodities
equities_1hhour250US equities & ETFs
universe_1hhour97Perpetuals & funding, Market structure & DeFi
macro_1hhour96Global indices & commodities, Options & volatility
block_hourhour58Bitcoin node
crypto_1ddaily573Crypto spot, Perpetuals & funding, Market structure & DeFi
universe_1ddaily187Market structure & DeFi, Sentiment & attention, ETF flows
forex_1ddaily181FX, Global indices & commodities
equities_1ddaily140US equities & ETFs, Market structure & DeFi
macro_1ddaily104Global indices & commodities, Options & volatility, Macro & rates
block_dailydaily58Bitcoin node
crypto_epochdaily2On-chain network, Market structure & DeFi
block_weeklyweekly58Bitcoin node
universe_1wweekly32Positioning (CFTC), Macro & rates
block_monthlymonthly58Bitcoin node
macro_1mmonthly15Macro & rates
block_quarterlyquarterly58Bitcoin node
macro_1qquarterly2Macro & rates

Coverage & integrity (inventories, 2026-09-19)

Measured facts, not estimates. Inventory counts are from 2026-10-11; first-observation and gap statistics are from the September column measurement.

MetricValue
Raw datapoints listed3,845 across 1,871 fields
Raw observations1.51B
Cadences (raw)9 — 1 min · 5 min · 10 min · 30 min · hourly · daily · weekly · monthly · quarterly
History floor2023-08-10 · node store from 2022-07-01
Datapoints reaching the floor3,323
Interior gaps73,845 cells · 0.0049% of observations
Derived series293,743 · 40,895 names · 79 formulas · 13 cadences

Why a datapoint starts after the floor. A series can't have history from before the thing it measures existed, so coins, tickers, ETFs, perps and CFTC contracts start at their launch. Two groups are short for our own reasons and are named rather than hidden:

Everything listed that starts in 2025-06 or later: ada_fees_native (209), ada_supply_native (209), btc_blk_utxo_increase_actual (2026-07-01), btc_blk_utxo_increase_actual (2026-08-01), btc_blk_utxo_increase_actual (2026-08-06), btc_blk_utxo_increase_actual (2026-08-10), btc_blk_utxo_size_inc_actual (2026-07-01), btc_blk_utxo_size_inc_actual (2026-08-01), btc_blk_utxo_size_inc_actual (2026-08-06), btc_blk_utxo_size_inc_actual (2026-08-10), btc_dominance (2026-02-13), btc_mempool_total_fee (2026-07-11), btc_option_vol (2026-07-10), cftc_bch_perp_cbd (2026-01-15), cftc_btc_nano_cbd (2025-07-24), cftc_btc_nano_perp_cbd (2025-07-24), crcl_close (2025-06-05), crcl_high (2025-06-05), crcl_low (2025-06-05), crcl_open (2025-06-05), crcl_trade_count (2025-06-05), crcl_volume (2025-06-05), crcl_vwap (2025-06-05), crypto_active_coins (2026-02-13), crypto_mcap_change_24h (2026-02-13), crypto_mcap_total (2026-02-13), crypto_volume_total (2026-02-13), defi_dominance (2026-02-13), defi_mcap (2026-02-13), defi_volume_24h (2026-02-13), etf_btc_aum_usd_m (2025-06-05), etf_eth_aum_usd_m (2025-06-05), eth_dominance (2026-02-13), eth_option_vol (2026-07-10), gram_hl_funding (2026-07-02), mon_hl_funding (2025-10-08), pump_hl_funding (2025-07-10), xmr_hl_funding (2026-01-15), zec_hl_funding (2025-10-02).

Naming

Market calendar — when a field is allowed to be flat

Every datapoint is classified by when its source actually trades. A flat value is only healthy when the market is genuinely closed.

ClassDatapointsClosesA flat value means
24/7 continuous2,219neverbroken if flat — crypto, node, on-chain, DeFi, sentiment
US equity hours813nightly + weekendsOK overnight and weekends; stale in the US session = broken
FX, weekdays 24h704weekends onlyOK Fri ~21:00 → Sun ~21:00 UTC; stale on a weekday = broken
Release-based108on releasejudged by the expected release interval — macro, rates, COT

US equity session ≈ 13:30–20:00 UTC. FX ≈ Sun 21:00 → Fri 21:00 UTC. Derived series inherit the calendar of their inputs.

Close nightly and on weekends. Equities, ETFs, the index and commodity proxies and the VIX family hold their last value overnight and all weekend: aapl, aapl_trade, aapl_volume, amzn, amzn_trade, amzn_volume, bito, bito_trade, cifr, cifr_trade, clsk, clsk_trade, clsk_volume, coinb, coinb_trade, coinb_volume, copper, corz, corz_trade, crcl, crcl_trade, dax, dia, dia_trade, dia_volume, dow, dxy, etha, etha_trade, etha_volume, eurostoxx, fbtc, fbtc_trade, ftse, gbtc, gbtc_trade, glxy, glxy_trade, gold, googl, googl_trade, googl_volume, hood, hood_trade, hsi, hut8, hut8_trade, hut8_volume, hyg, hyg_trade, ibit, ibit_trade, iren, iren_trade, iwm, iwm_trade, iwm_volume, kospi, mara, mara_trade, mara_volume, meta, meta_trade, meta_volume, msft, msft_trade, msft_volume, mstr, mstr_trade, mstr_volume, nasdaq, natgas, nikkei, nvda, nvda_trade, nvda_volume, oil, palladium, platinum, qqq, qqq_trade, qqq_volume, riot, riot_trade, riot_volume, russell2000, silver, skew, smh, smh_trade, sp500, spy, spy_trade, spy_volume, tlt, tlt_trade, tsla, tsla_trade, tsla_volume, uranium, vix, vix3m, vix9d, wulf, wulf_trade, xlk, xlk_trade, xlk_volume

Close on weekends only. The FX pairs trade 24 hours on weekdays and hold from Friday evening to Sunday evening: audcad, audjpy, audnzd, audusd, cadchf, cadjpy, chfjpy, euraud, eurcad, eurchf, eurgbp, eurjpy, eurnok, eurnzd, eurpln, eursek, eurtry, eurusd, gbpaud, gbpcad, gbpchf, gbpjpy, gbpnzd, gbpusd, nzdcad, nzdchf, nzdjpy, nzdusd, usdcad, usdchf, usdcnh, usdczk, usddkk, usdhkd, usdhuf, usdjpy, usdmxn, usdnok, usdpln, usdsek, usdsgd, usdthb, usdtry, usdzar

How to pull only the fields you want

Pass a comma-separated series= list (or a * pattern, or markets= + fields=) to any window call. timestamp is always the first column and never listed.

curl -H "X-API-Key: tk_live_xxx" \
  "https://api.tillacrypto.com/v1/pro/raw/1min?series=btc_close,eth_close,btc_volume&period=1d"