English Français العربية

TILLA - market data on one clock

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • TILLA_API_KEY إلزامي سري 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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو TILLA - market data on one clock؟

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

كيف أثبّت TILLA - market data on one clock؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج TILLA - market data on one clock إلى مفتاح API؟

نعم. يتطلب TILLA_API_KEY، وتضبطها في إعداداته.

هل TILLA - market data on one clock مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون TILLA - market data on one clock؟

ينشره TillaCrypto. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.