English Français العربية

TILLA - market data on one clock

Registre officiel Finance et paiements

Crypto, US stocks, FX, rates, macro and Bitcoin node data on one clock, for any AI agent.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package tilla-mcp
Claude Code 
claude mcp add tilla-market-data-on-one-clock -e 'TILLA_API_KEY=<your tilla_api_key>' -e 'TILLA_API_BASE=<TILLA_API_BASE>' -- uvx tilla-mcp==2.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tilla-market-data-on-one-clock": {
            "command": "uvx",
            "args": [
                "tilla-mcp==2.0.1"
            ],
            "env": {
                "TILLA_API_KEY": "<your tilla_api_key>",
                "TILLA_API_BASE": "<TILLA_API_BASE>"
            }
        }
    }
}

Variables d'environnement

  • TILLA_API_KEY obligatoire secret Your TILLA API key (tk_live_...). Get a free one at https://tillacrypto.com
  • TILLA_API_BASE API base URL. Defaults to https://api.tillacrypto.com

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. TILLA
  2. In your AI agent (MCP)
  3. A key and a first call
  4. What's in here
  5. The three calls behind it
  6. Safe to run
  7. License
  8. Contact

TILLA

Market data for trading models, bots and AI agents. Crypto, US stocks and ETFs, FX, rates and macro on one UTC clock, from 1-minute bars to quarterly.

  • Every market lines up. BTC, NVDA, EUR/USD, the 10-year yield and VIX share the same timestamp. No joins, no drift.
  • Bitcoin and Ether spot ETF flows, fund by fund, daily, next to price, funding and open interest.
  • 293,743 derived indicators, computed bar by bar with no look-ahead.
  • Our own Bitcoin node: blocks, mempool and fees on the same clock as the market.
  • Your copy never breaks. Go offline and one call refills every missed bar; a second call delivers every value a source corrected later.
  • History: hourly crypto from 2017, FX from 2002.

Site: https://tillacrypto.com · Docs: https://tillacrypto.com/docs · Plans: https://tillacrypto.com/pricing

In your AI agent (MCP)

pip install tilla-mcp
{
  "mcpServers": {
    "tilla": {
      "command": "tilla-mcp",
      "env": { "TILLA_API_KEY": "tk_live_your_key_here" }
    }
  }
}

With uv there is nothing to install: "command": "uvx", "args": ["tilla-mcp"].

14 tools for Claude, Cursor or any MCP client: latest bars, history, one whole market at a time, the live tick, corrections and plans. Ask things like "BTC price against spot ETF flows this month" or "NVDA and BTC on one hourly chart". Tool list: mcp/README.md.

A key and a first call

A free key, no account and no card:

curl -X POST https://api.tillacrypto.com/v1/demo_key
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. JSON, CSV, NDJSON or Parquet (format=). A Postman collection has every call ready to run.

What's in here

FolderWhat it is
starter/tilla_dashboard.py: a live terminal dashboard that keeps a SQLite copy current - resume what you missed, tick every new bar, heal what a source corrected. Standard library only.
mcp/tilla_mcp.py: the MCP server (also pip install tilla-mcp)
examples/three short scripts: a first call, every coin's close in one call, a day of data in pandas
postman/the API as a Postman collection
cd starter
python tilla_dashboard.py --keep tilla.db

The three calls behind it

  • 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
  • Changes - GET /v1/<tier>/changes?since=... - every value corrected since a time, so your copy gets the fix

Safe to run

Everything here only reads market data from api.tillacrypto.com over HTTPS. Nothing trades, touches a wallet or reads your other files. Your key stays in your own .env or environment and goes only to the TILLA API. The only thing written is the SQLite file you name with --keep.

License

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

Contact

I answer every message myself: https://tillacrypto.com/contact, @TillaCryptoHub on X, or an issue on this repo.

Questions fréquentes

Qu'est-ce que TILLA - market data on one clock ?

Crypto, US stocks, FX, rates, macro and Bitcoin node data on one clock, for any AI agent.

Comment installer TILLA - market data on one clock ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add tilla-market-data-on-one-clock -e 'TILLA_API_KEY=<your tilla_api_key>' -e 'TILLA_API_BASE=<TILLA_API_BASE>' -- uvx tilla-mcp==2.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour TILLA - market data on one clock ?

Oui. Il attend TILLA_API_KEY, à renseigner dans sa configuration.

TILLA - market data on one clock est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient TILLA - market data on one clock ?

Il est publié par TillaCrypto. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.