TILLA

TILLA

Market data for people building trading models, bots and AI agents: crypto, US stocks and ETFs, FX, indices, commodities, rates and macro on one 1-minute clock, plus data from a Bitcoin node I run myself.

This repo is everything you need to start, free: a live terminal dashboard that keeps a local copy of the data in sync, an MCP server so your AI agent can pull the data itself, and three short examples.

Site: https://tillacrypto.com · Docs: https://tillacrypto.com/docs · X: @TillaCryptoHub

Use it from your AI agent (MCP) - 30 seconds

Give Claude, Cursor or any MCP client the whole market as tools (14 of them: latest bars, history, one market at a time, the live tick, repairs, plans):

pip install "mcp>=1.2,<2" httpx

{
  "mcpServers": {
    "tilla": {
      "command": "python",
      "args": ["/path/to/tilla/mcp/tilla_mcp.py"],
      "env": { "TILLA_API_KEY": "tk_live_your_key_here" }
    }
  }
}

Then ask your agent things like "BTC funding vs ETF flows this week" or "NVDA and BTC on one hourly chart". Full tool list: mcp/README.md.

Get a free key (no account, no card)

curl -X POST https://api.tillacrypto.com/v1/demo_key

Or sign up at https://tillacrypto.com for a free key tied to your account.

Your first call

curl -H "X-API-Key: tk_live_YOUR_KEY" "https://api.tillacrypto.com/v1/free/raw/1min?series=btc_close,eth_close&limit=5"

Every bar is labelled by its close, in UTC. A value a source never published stays empty; nothing is guessed.

What's in here

Folder	What it does
starter/	tilla_dashboard.py - one command keeps a SQLite copy current: resume what you missed, tick every new bar, heal values a source corrected later. Standard library only.
mcp/	tilla_mcp.py - the MCP server for Claude, Cursor or any MCP client
examples/	three short scripts: your first call, every coin's close in one call, a day of data into pandas

cd starter
python tilla_dashboard.py --keep tilla.db

The three calls the dashboard is built on

• Tick - GET /v1/<tier>/tick - every series your plan holds for the bar that just closed, in one answer
• Resume - GET /v1/<tier>/resume/<layer>/<lane>?since=... - every bar since you stopped, streamed
• Heal - GET /v1/<tier>/changes?since=... - every value corrected since a time, so your copy gets the fix

Plans

Free forever with no card. Paid plans add more markets, more history and more clocks: https://tillacrypto.com/pricing

Safe by design

• Read-only. Everything here only reads market data from api.tillacrypto.com over HTTPS. Nothing places trades, touches a wallet or reads your other files.
• Your key stays yours. It is read from your own .env or environment and sent only to the TILLA API. No key is in this repo, and .gitignore keeps .env out of any commit.
• What gets written: only the SQLite file you name with --keep (the dashboard). The MCP server writes nothing.
• Open code, MIT licensed. Read every line before you run it. The MCP server is one file: mcp/tilla_mcp.py.

Licence

The code is MIT (see LICENSE). The market data you pull with it is governed by your TILLA plan terms: https://tillacrypto.com/docs

Questions

I answer every message myself: https://tillacrypto.com/contact, or a DM on X. Issues on this repo are welcome too.