Market overview
Markets & Macro

| Instrument | 90-day trend | Last | 1D | 30D |
|---|
| Asset | 90-day trend | Last | 1D | 30D |
|---|
- Rate decision · 2:00 PM ET
- Chair's press conference · 2:30 PM ET
- The day's rates are in the API: sofr, ust_3m … ust_30y
ETF flows
US spot funds · daily net creations and redemptions, in US dollars.
3,854 raw. 280,675 derived.
One clock. One API.
A pre-aligned crypto market store — price, perpetuals, our own Bitcoin node, on-chain, per-fund ETF flows and full macro, every field on one clock. Others sell the pieces; the alignment is the product. Built for models, not dashboards.
curl -H "X-API-Key: tk_live_…" \
"https://api.tillacrypto.com/v1/free/raw/1min?series=btc_close,eth_close&limit=60"
# put your tier where free is; add &format=csv, ndjson or parquet
r = requests.get("https://api.tillacrypto.com/v1/builder/market/btc",
params={"lane": "hour", "period": "30d"},
headers={"X-API-Key": KEY}).json()
df = pd.DataFrame(r["data"], columns=["timestamp"] + r["series"])
Every series we sell, by name. Search all of it.
Raw is what the venues, our node and the agencies publish, aligned to one clock. Derived is everything we compute from it: indicators, statistics and cross-asset relationships.
Counts come from the raw and derived inventories (2026-10-11). A datapoint is one field at one cadence. Series marked PRO+ are included from the Pro plan up.
- BTC & ETH + S&P 500, gold, VIX, DXY · 108 fields
- 30-day history + deep BTC/ETH hourly back to 2017
- BTC · ETH prices and core indicators
- Fear & Greed · dominance · DXY · VIX
- Live 1-minute bars · JSON, CSV, NDJSON, Parquet
- 20,185 fields
- 6 months of history + deep hourly before it
- 45 coins · 33 US stocks & ETFs at 1 minute
- Every BTC & ETH spot ETF, fund by fund
- Every indicator, every cadence
- 120 requests a minute
- 31,499 fields
- 1.5 years of history + all deep hourly before it
- 44 FX pairs · perps, funding & OI · options · rates & macro
- Every indicator down to 1 minute
- Bulk export of your whole window
- Commercial-use license · 300 req/min
- Everything — all 41,771 fields
- The whole history, every cadence, since August 2023
- Deep hourly before it: crypto from 2017, FX from 2002
- Every BTC & ETH spot ETF, fund by fund
- Our own Bitcoin node — blocks, fees, UTXO flow, mempool
- All 280,675 derived series, warm from day one
- Commercial-use license
- 600 requests a minute
The whole matrix, no limits.
For desks, funds and data teams that need everything at once — with the licensing, scale and assurance to run it in production.
Every tier streams live — your look-back sets where history starts, the feed never stops. Cancel anytime; your downloaded data is yours.
API dashboard
/v1.https://api.tillacrypto.comGET /v1/{tier}/tick — live: every series your plan holds, on every cadence that just closed, in ONE answer. Ask once a minute.GET /v1/{tier}/resume/{layer}/{lane}?since=… — catch up: everything since you last stopped, one request a lane — a minute, two days or a month.GET /v1/{tier}/changes?since=… — stay correct: every value our own checks repaired since then, so your copy is fixed when ours is.python tilla_dashboard.py --keep tilla.db — it resumes where it stopped, ticks every minute and heals every ten minutes.API documentation
Why TILLA is different
Authentication
Starter package
Rate limits, tiers & speed
Errors
Standard HTTP codes with a JSON body: {"error": "...", "code": 403}. Every answer carries X-Request-Id. The same table, as a sheet, is in GET /v1/calls?format=csv.
| Code | Meaning | What to do |
|---|---|---|
| 400 | Bad parameter - a bad date, start after end, an unknown parameter | Fix the request; the body says which |
| 401 | Missing key | Send X-API-Key: tk_live_... |
| 403 | Invalid or revoked key, or a series / lane / call outside your tier | /v1/inventory shows what your key holds - or upgrade |
| 404 | Unknown endpoint, tier, lane or receipt | GET /v1/calls lists every call |
| 405 | Method not allowed - the API is read-only | Use GET (or HEAD) |
| 409 | Already done - a just-bought key is shown once | Rotate the key from your dashboard |
| 413 | Request too large | Fewer series, or a shorter window |
| 429 | Rate limit, daily quota, rows or breadth | Wait the seconds in Retry-After; X-RateLimit-* shows your budget |
| 500 | Our fault | Retry once; send the X-Request-Id to support if it repeats |
| 503 | Maintenance - the data engine is restarting | The live calls (tick, stream, latest) pause; every history call keeps working and carries X-Tilla-Maintenance: 1. Wait Retry-After and ask again |
Endpoints
Data catalog
Tables, coverage & calendar
How the clock works
One clock. Every value is labelled by the close of its bar, in UTC. Bar T covers (T-1, T], so a midnight daily label closes the day before. Crypto, stocks, FX, macro, ETF flows and the Bitcoin node all use the same labels, so rows line up with no resampling.
Only closed bars. A bar is served once it has closed. A forming bar, day, week, month or quarter is never served.
Closed markets. When a market is shut (a weekend or a holiday), its series carry the venue's last real print. Nothing else is forward-filled: a value a source never published stays empty, and an indicator with a flat input (0 ÷ 0) stays empty too.
Corrections. When a venue or an agency revises a number, the corrected value replaces it and appears in GET /v1/{tier}/changes, so your copy can take the fix.
Indicators. The 280,675 derived series are computed bar by bar from the raw, using only bars at or before T - no look-ahead.
History. The aligned set starts in August 2023. Before it, the deep hourly history goes back to 2017 for crypto and 2002 for FX.
Cadences. 1-minute bars to quarterly. ETF flows are daily. Order-book depth is captured every 5 minutes.
Retired markets. A market that stops for good keeps its history up to its last real bar and is never filled after it.
Every tier, every lane
How many series each plan holds on every lane, read live from GET /v1/tiers - the same numbers /v1/inventory gives your key. A dash is a lane the tier does not hold. Your own list, with the URL of every call: GET /v1/calls?tier=<your tier>&format=csv.
| Loading ... |
Free
Builder
Pro
Max
Enterprise
Samples
Every plan has free samples, served straight from the API with no key. Open the .csv in Excel, the .db files with any SQLite tool, or hand them to your AI.
- The snapshot - the newest value of every series the plan holds, on every lane, at 20:00 UTC of one fixed past day: Free 2026-10-22, Builder, Pro and Max 2026-10-02 (
.csvand.db). A sample is a fixed day on purpose; your key reads the live set. - One whole day - every bar of every series that plan holds for one full UTC day, on every lane (
.db). Builder, Pro and Max show 2026-10-02; Free shows 2026-10-22, inside its 30-day window.
| Plan | Snapshot | One day |
|---|---|---|
| Free | .csv · .db | .db |
| Builder | .csv · .db | .db |
| Pro | .csv · .db | .db |
| Max | .csv · .db | .db |
What each file holds, in JSON: GET /v1/sample/<plan> and GET /v1/sample/<plan>_day. Every plan card also has a Samples ↓ link.
About
Guides
Walk-throughs, one per job: Sheets & Excel, trading without code, ETF flows, history and refills, the Bitcoin node, ML features and AI agents. Each is below, in this order.
Sheets & Excel
One formula, live rows. A 2-minute setup, then it works like any other cell.
Google Sheets. 1. Get a free key (no account needed: POST https://api.tillacrypto.com/v1/demo_key). 2. In your sheet: Extensions → Apps Script, paste the code below and save. 3. Project Settings → Script Properties → Add: name TILLA_KEY, value your key, so the key stays out of the sheet. 4. In any cell: =TILLA("btc_close,eth_close", "hour", 24)
/** TILLA market data in a cell. =TILLA(series, lane, limit, layer, tier) */
function TILLA(series, lane, limit, layer, tier) {
var key = PropertiesService.getScriptProperties().getProperty('TILLA_KEY');
if (!key) return 'Add your key: Project Settings > Script Properties > TILLA_KEY';
var url = 'https://api.tillacrypto.com/v1/' + (tier || 'free') + '/' + (layer || 'raw') + '/' + (lane || 'hour')
+ '?series=' + encodeURIComponent(series) + '&limit=' + (limit || 100);
var r = UrlFetchApp.fetch(url, {headers: {'X-API-Key': key}, muteHttpExceptions: true});
if (r.getResponseCode() !== 200) return 'TILLA ' + r.getResponseCode() + ': ' + r.getContentText().slice(0, 120);
var j = JSON.parse(r.getContentText());
return [['timestamp'].concat(j.series)].concat(j.data);
}
More: =TILLA("btc_rsi_14", "daily", 30, "derived") · =TILLA("sp500_close,gold_close,dxy_close", "daily", 60).
Excel (Power Query). Data → Get Data → From Other Sources → From Web → Advanced. URL https://api.tillacrypto.com/v1/free/raw/hour?series=btc_close,eth_close&limit=100&format=csv, header X-API-Key = your key, then Load. Data → Refresh All pulls the newest rows. Each refresh is one request against your plan's per-minute limit.
For traders, no code
If you trade from a spreadsheet, a chart or a morning checklist, TILLA puts the numbers in one place on the same clock: BTC beside the S&P 500, gold or the dollar on the same minute, without copying from five websites.
- Spot ETF flows, fund by fund - every US spot Bitcoin and Ether ETF, per day.
- Derivatives - funding, open interest and long/short ratios.
- Sentiment and risk - Fear & Greed, VIX, the yield curve, the dollar index and the Fed rate.
- Indicators already computed - RSI, EMAs, MACD, Bollinger Bands, returns, volatility, betas and correlations.
Three ways in without code: a formula in Sheets or Excel, &format=csv on any call, or an AI assistant through the MCP server. TILLA is a data service: no trades, no signals, no advice, and the finest bar is 1 minute.
ETF flows
Every US spot Bitcoin and Ether ETF as one column per fund, one row per day, in millions of US dollars, on the same UTC clock as price, funding and the dollar index.
- Bitcoin funds: IBIT, FBTC, GBTC, ARKB, BITB, HODL, BRRR, EZBC, BTCO, BTCW, MSBT and BTC, with the daily total, the running total and assets under management.
- Ether funds: ETHA, ETHE, FETH, ETHW, ETHV, QETH, EZET, ETHB, TETH, ETH and MSSE, with the daily total and assets under management.
- Daily from each fund's launch (Bitcoin funds from 2024-01-11). A day is filled once the issuers have all reported; a later correction reaches you through
/changes. - Indicators on the flows themselves: moving averages, z-scores, momentum and percentiles, with no look-ahead.
GET https://api.tillacrypto.com/v1/builder/raw/daily?series=btc_etf_ibit,btc_etf_fbtc,btc_etf_flow,btc_close&period=30d X-API-Key: tk_live_...
ETF flows start at Builder. Flows are daily, as the issuers publish them; there are no intraday flows.
History & refills
Go offline for an hour or a week: one call brings back every bar you missed, and a second brings every value a source corrected later.
- Tick -
GET /v1/<tier>/tick: every series your plan holds for the bar that just closed. - Resume -
GET /v1/<tier>/resume/<layer>/<lane>?since=...: every bar since you stopped, in one streamed request (JSON lines, CSV or Parquet). - Changes -
GET /v1/<tier>/changes?since=...: every value corrected since a time. Apply them and your copy matches ours.
The free starter package does all three in one command: python tilla_dashboard.py --keep tilla.db. Hourly history reaches back to 2017 for crypto and 2002 for FX (/v1/<tier>/deep/hour); every clock from 1-minute to quarterly runs from August 2023.
Bitcoin node data
TILLA runs its own Bitcoin full node and builds its block data from it directly. Each block is folded onto the same UTC bars as the market, from 10-minute to quarterly, so a fee spike lines up with that hour's funding, ETF flow and price.
- Block economics - total fees, minimum fee and fee rate, subsidy, block time and difficulty.
- Fee percentiles, UTXO and block structure, transaction types (size bands, batching, consolidation, dust, multisig) and the mempool.
- Indicators on all of it, with no look-ahead.
GET https://api.tillacrypto.com/v1/max/node/hour?series=btc_blk_blocks&limit=24
Node data is in Max and Enterprise.
ML features
The hard part of a crypto model is building clean, aligned features without leaking the future into the past. Every TILLA indicator is one formula over the raw, computed on its own clock from bars at or before its label.
- Technicals - EMA distances, RSI, MACD, Bollinger width and %b, returns and volatility.
- Cross-asset - betas and correlations to the dollar, gold, the S&P 500 and the 10-year yield.
- Positioning and flow - funding, open interest, long/short, taker flow, CFTC positioning and ETF flows.
- Regime - Fear & Greed, VIX and its term structure, calendar features.
Series on one lane share one label, so an X matrix is one window call. Take a whole lane at once with /v1/<tier>/resume/derived/<lane>?since=...&format=parquet.
AI agents (MCP)
The TILLA MCP server gives Claude, Cursor or any MCP client the API as 14 read-only tools. Each tool calls one route with your key, so the agent sees exactly what your plan holds. It is on the Official MCP Registry as io.github.TillaCrypto/tilla-mcp.
pip install tilla-mcp
{ "mcpServers": { "tilla": { "command": "tilla-mcp", "env": { "TILLA_API_KEY": "tk_live_..." } } } }
With uv there is nothing to install: "command": "uvx", "args": ["tilla-mcp"]. Start with tilla_inventory (every series the key holds), then tilla_latest, tilla_window, tilla_market, tilla_tick and tilla_changes. The tools only read market data: no trades, no files, no commands. Source on GitHub.
Where TILLA is listed
TILLA (also written TillaCrypto, Tilla Crypto, tillacrypto.com) is the market data API at tillacrypto.com - one company, built by Colbie. These are its official pages elsewhere:
- X - news and releases
- GitHub - the public client code
- GitHub repository - examples, the starter kit and the MCP server
- PyPI - the MCP server package: pip install tilla-mcp
- Official MCP Registry - io.github.TillaCrypto/tilla-mcp
- Glama - MCP server directory
- mcpservers.org - MCP server directory
- Cursor Directory - Cursor plugin
- mcptry - MCP server checks
- Postman - the whole API as a Postman collection
- Kaggle - a free sample dataset
- Trustpilot - reviews
- G2 - reviews
- Crunchbase - company profile
- Product Hunt - maker profile
- DevHunt - developer tools
- Peerlist - project page
- dev.to - articles
- Hashnode - articles
Support
I answer every message myself - keys, billing, data questions, bugs, enterprise, anything.
Response time. Usually the same day, always within one business day. An outage gets handled the moment I see it.
Before you email — the fast fixes ▾
Missing or wrong key. Send Authorization: Bearer tk_live_…. Rotate a lost key from your dashboard.
You asked for a column your plan doesn't include. Call /v1/inventory to see exactly what your key can pull, or upgrade.
You hit your per-minute or daily limit — back off and honor the Retry-After header, or move up a tier.
If the latest row stops advancing, check /v1/status — the feed pauses on rare source outages and resumes on its own; you keep every row you already pulled.
What to include so we can help fast: your account email or customer number, the endpoint and exact request, the response code, and a timestamp. Never paste your full API key in an email — the last 4 characters are enough.
Status & uptime. Live health is public at /v1/status and /v1/health (no key needed) — feed freshness, per-tier windows and any open outage. Bookmark it before you email about "is it down."
Security & responsible disclosure. Found a vulnerability? Email support@tillacrypto.com with "SECURITY" in the subject. We respond quickly, we won't pursue good-faith researchers, and we credit fixes.
Feature & data requests. Want a column, an asset, or an endpoint we don't have yet? Tell us. I read every request, and the ones many customers need get built.
FAQ
Privacy
Nothing is sold or shared with anyone — ever. No third-party analytics, no advertising trackers, no cookies beyond what's needed to keep you signed in. Preferences you save on the terminal live in your browser's local storage and never leave your device. We keep standard server logs (IP, timestamp, endpoint) briefly, for security and abuse prevention only, then discard them.
Terms of use
Written plainly and honestly - no traps, no dark patterns. Market data and any model output are provided for research, education and entertainment. API access is governed by the published tiers. By using the API you agree to keep your key private, stay within your tier's rate limits, and not attempt to access data outside your plan. We may suspend or revoke keys that abuse the service, attempt to circumvent tier limits, or scrape at volume.
1 - Your account. Your account is your email and password, managed securely by our auth provider. We never see or store your raw password. Your API key is tied to your verified email and kept on our servers only as a hash.
2 - Subscriptions & billing. Paid tiers (Builder, Pro, Max) are monthly subscriptions billed through Stripe, renewing automatically until you cancel. Free is free forever, no card required.
3 - Upgrading - prorated & instant. Upgrade any time. When you move up a tier mid-cycle we credit the unused time on your current plan toward the new one - you only pay the difference, prorated automatically. Your extra fields and history unlock immediately, your existing key keeps working, your prior subscription is replaced (never stacked), and anything you've already pulled is never touched.
4 - Downgrading & cancelling. Cancel or downgrade any time from your dashboard. You keep full access to your current tier through the end of the period you've paid for, then it steps down. No lock-in, no cancellation fees.
5 - Refunds. Subscriptions are non-refundable. You can start free, see exactly what every tier includes, and cancel any time with access through your paid period - so payments already made aren't refunded. If something genuinely broke on our end, email support@tillacrypto.com.
6 - Our commitment to you. We will provide the value you paid for, 100%, and we stand behind it. For the entire period you have paid for, we are legally committed to keep the data and the live API available to you at the tier and access level you purchased. If the feed has an issue, we fix it and make it right. We will never do anything malicious with your account, your data, or your trust - no surprise charges, no selling you out, nothing shady, ever.
7 - Fair use. Your key is for you. Don't share it, don't publish it in a public web page or repo, and don't resell or redistribute the raw feed. Rate limits protect the feed for everyone.
8 - Data & privacy. We store the minimum: your email, your tier, and a hash of your key. We do not sell your data and we don't track you across the web.
9 - The legal bits. The service is provided "as is." We work hard for uptime and accuracy but can't guarantee markets or third-party sources never hiccup; our liability is limited to the amount you've paid us. We may update these terms and will flag anything material.
By creating an account or completing checkout, you confirm you've read and agree to these terms - and we, in turn, are legally committing to deliver the value described above.
Data license
You may use the data you pull — including the history you accumulate over time from the live feed — inside your own models, research, dashboards and internal tools.
You may not resell, redistribute, republish, or otherwise make the raw feed (or a substantial copy of it) available to any third party. Reselling or redistributing the datasets is prohibited on every tier, including Max. One customer may not become a data vendor of ours.
Commercial use — Pro and Max include a full commercial license: the data may be used in any commercial product, fund, trading system or paid service, and to train, sell and deploy machine-learning and AI models; the models and their outputs belong to you. Reselling, redistributing or republishing the raw data itself requires an Enterprise license.
Risk disclosure
TILLA is not an investment adviser and nothing here is financial advice. Any model output is automated and can be wrong. Backtests are hypothetical — they assume no execution, fees or slippage — and past performance never guarantees future results. Crypto is extremely volatile; never risk money you cannot afford to lose. You are solely responsible for your own decisions.
TILLA