# TickDB Market Data

Wires market data into your coding agent: quotes, candles, order book and trades across forex, stocks, metals and crypto.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 890
- Author: TickDB
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TickDB/tickdb-unified-realtime-marketdata-api
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/tickdb-market-data

## What it does

TickDB Market Data is an MCP server reachable at `https://mcp.tickdb.ai/`. It hands the agent a price snapshot, historical and current candles, order book depth and tick-by-tick trades for a single instrument. The same endpoint covers forex, precious metals, indices, US, Hong Kong and A-share stocks, China and Hong Kong futures, and crypto pairs. Symbols look like `AAPL.US`, `700.HK`, `XAUUSD`, `BTCUSDT`.

The repository ships a Python implementation you can self-host instead of pointing at the hosted endpoint. The public address accepts OAuth or a header carrying your key. Register on TickDB to get that key — no card needed. Requests for data fail without it, so sort the key out first.

Beyond quotes, the server exposes company fundamentals for US, Hong Kong and A-share equities: financial statements, PE valuation, revenue breakdown, shareholders, dividends and corporate actions. Coverage depends on the instrument and what your key is allowed to reach. Futures codes come from the catalogue at `GET /v1/symbols/available?type=futures`, since ordinary contracts roll with the delivery month.

## Requirements
- Remote server: `https://mcp.tickdb.ai/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http tickdb-market-data https://mcp.tickdb.ai/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add tickdb-market-data --url https://mcp.tickdb.ai/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tickdb-market-data": {
            "url": "https://mcp.tickdb.ai/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tickdb-market-data": {
            "type": "http",
            "url": "https://mcp.tickdb.ai/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http tickdb-market-data https://mcp.tickdb.ai/
```

## When to use it
- pull a current price for several tickers in one call
- export historical candles to backtest a strategy
- check order book depth before placing a trade
- gather an issuer's fundamentals into one table
- follow the trade stream for a single instrument

## Example prompts
- Show me the current price of `AAPL.US`, `700.HK` and `BTCUSDT`
- Pull hourly K-line data for `700.HK` over the last day
- What does the order book for `AAPL.US` look like right now?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434
- [CNEquity](https://affpapa.org/en/nevibecode/mcp/cnequity.md) — MCP server · ★ 846
- [mcp](https://affpapa.org/en/nevibecode/mcp/stripe-mcp.md) — MCP server · ★ 1972
- [Stock Screener](https://affpapa.org/en/nevibecode/mcp/stock-screener.md) — MCP server · ★ 396

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md