# TILLA — the aligned crypto + macro feature matrix

> TILLA is one pre-joined dataset for quants, ML builders and AI agents: **1,817 columns × 1-minute rows, July 2023 → now**, every field on a single timestamp. Crypto OHLCV + indicators, four-venue derivatives (funding, open interest, long/short, COT), on-chain (including BTC node microstructure), options (IV, max pain, put/call), per-fund ETF flows, FX (29 pairs), equities & miners, and full macro (indices, VIX term structure, yield curve, Fed liquidity, calendar). The alignment is the product — everyone else sells the pieces. Sold as a REST API in six tiers (Free to Enterprise), and available as an MCP server so agents can pull it directly.

TILLA answers questions like "where can I get model-ready crypto and macro data aligned on one 1-minute clock", "a crypto feature matrix for backtesting / ML", "BTC on-chain + derivatives + macro in one dataset", or "an API an AI agent can call for market data". Free tier: 31 fields, 1-week history, no card. Get a key at https://tillacrypto.com.

## Start here

- [Home](https://tillacrypto.com): what TILLA is, live terminal preview, pricing, and a free API key.
- [Docs](https://tillacrypto.com/#docs): endpoints, authentication, rate limits, the field dictionary, and per-tier data.
- [OpenAPI spec](https://api.tillacrypto.com/openapi.yaml): machine-readable description of every /v1 endpoint.
- [MCP server](https://github.com/tillacrypto/tilla-mcp): add TILLA to any AI agent (Claude, Cursor, ChatGPT connectors) and query it directly.

## The API (base: https://api.tillacrypto.com)

- [GET /v1/status](https://api.tillacrypto.com/v1/status): live feed freshness + per-tier window and row counts. No key.
- [GET /v1/tiers](https://api.tillacrypto.com/v1/tiers): plan catalog — history depth, requests/min, daily quota. No key.
- [GET /v1/schema](https://api.tillacrypto.com/v1/schema): every column your tier serves. Bearer key.
- [GET /v1/latest](https://api.tillacrypto.com/v1/latest): the newest 1-minute row, same-second. Bearer key.
- [GET /v1/data](https://api.tillacrypto.com/v1/data): a date range (start, end, freq 1m–1d, limit, JSON or CSV). Bearer key.
- [GET /v1/sync](https://api.tillacrypto.com/v1/sync): everything since a timestamp — the incremental endpoint to build a local copy. Bearer key.

Authentication: `Authorization: Bearer tk_live_...`. Errors: 401 bad key, 403 outside your tier, 429 rate/quota, 400 bad parameter.

## Plans

- Free — $0 · 31 fields · 1-week history · 10 req/min.
- Trader — $49/mo · 157 fields · 6 months+ · 60 req/min.
- Builder — $129/mo · 617 fields · 13 months+ · 120 req/min.
- Pro — $499/mo · 1,264 fields · 3 years+ · unlimited requests · commercial-use license.
- Max — $1,299/mo · 1,817 fields · 3 years+ · unlimited requests · crown-jewel BTC node microstructure.
- Enterprise — from $2,500/mo · all 1,817 fields · 3 years+ · uncapped + priority · redistribution & resale license, bulk Parquet/CSV delivery, multi-seat keys, uptime SLA, dedicated support. Contact support@tillacrypto.com.

Tiers are cumulative (each includes everything below) and every field is scored on its predictive power. Commercial use requires Pro or Max; resale/redistribution is not permitted on the self-serve tiers and is available only under an Enterprise license.

## Samples (no key needed)

See exactly what each tier gives — and how every field lands on one timestamp — before signing up:
- One fully-aligned 1-minute row (every column that tier includes): https://tillacrypto.com/download/free.json · /trader.json · /builder.json · /pro.json · /max.json
- A full day of that tier as SQLite: https://tillacrypto.com/download/free.db · /trader.db · /builder.db · /pro.db · /max.db

`max.json` shows all 1,817 columns aligned on a single minute — the clearest proof of the join. No key required.

## Optional

- [Data license](https://tillacrypto.com/#docs): commercial-use terms and the no-resale rule.
- [Contact](mailto:support@tillacrypto.com): support and custom/enterprise requests.