TickerDB Docs
Factual market intelligence for AI agents & MCP clients
TickerDB provides pre-computed, categorical market data designed for LLMs and AI agents. Every response contains verifiable facts — no OHLCV, no raw uncomputed data, just derived categorical data.
Built for AI
All indicator-derived data is expressed as categorical bands (e.g. oversold, not RSI: 24). This vocabulary maps directly to how LLMs reason about markets.
Base URL
https://api.tickerdb.com/v1
What TickerDB Covers
- Asset Classes: US Stocks, Crypto, ETFs
- Timeframes: Daily, Weekly
- Update Frequency: End-of-day (EOD)
- Response Format: JSON
- Authentication: Bearer token
Endpoint Map
| Endpoint | Example Prompt | Use Case |
|---|---|---|
GET /v1/summary/:ticker | "How's AAPL looking?" | Single-asset intelligence (latest, historical, date range, events) |
GET /v1/search | "Show me all oversold tech stocks" | Multi-field filtering across all assets |
GET /v1/schema/fields | "What fields can I query?" | Discover all queryable fields, types, and values |
GET /v1/watchlist | "What changed on my watchlist?" | Portfolio monitoring |
POST /v1/webhooks | "Push changes to my URL" | Webhook notifications |
GET /v1/account | "What's my usage?" | Account & usage |
Design Principles
- Factual, not predictive — every field is a verifiable fact
- Current vs. historical norm — what's happening now vs. what's normal for this asset
- Categorical vocabulary — RSI zones, trend bands, volume ratios that LLMs already understand
- Per-asset behavioral context — historical streaks, medians, and percentiles specific to each asset
- Multi-signal intelligence — technical + fundamental + analyst sentiment in one response
- No raw market data — no OHLCV, no exact indicator values, no raw fundamental numbers
- Pre-computed — zero request-time computation, all data cached after market close
Quick Start
curl
# Get the full categorical snapshot for AAPL
curl "https://api.tickerdb.com/v1/summary/AAPL" \
-H "Authorization: Bearer YOUR_API_KEY"
# Search for oversold tech stocks
curl 'https://api.tickerdb.com/v1/search?filters=[{"field":"momentum_rsi_zone","op":"eq","value":"oversold"}]' \
-H "Authorization: Bearer YOUR_API_KEY"
# Check your watchlist for state changes
curl https://api.tickerdb.com/v1/watchlist/changes \
-H "Authorization: Bearer YOUR_API_KEY"
SDKs
Official client libraries that wrap the HTTP API. Install, initialize with your API key, and call methods directly.
| Language | Package | Install |
|---|---|---|
| Node.js | tickerdb | npm install tickerdb |
| Python | tickerdb | pip install tickerdb |
| Go | tickerdb-go | go get github.com/tickerdb/tickerdb-go |
MCP & Agent Frameworks
TickerDB has a native MCP server that works with any MCP-compatible client. Agent frameworks with MCP adapters can connect directly.
| Platform | Connection |
|---|---|
| Claude Desktop & Claude Code | MCP (local or remote) |
| Cursor | MCP (remote server) |
| Windsurf | MCP (remote server) |
| OpenClaw | MCP (native) |
| LangChain | MCP adapter |
| LlamaIndex | MCP adapter |
| AutoGen | MCP adapter |
| CrewAI | MCP adapter |
| OpenAI Custom GPTs | GPT Actions (HTTP) |
| Vercel AI SDK | SDK tools |
Automation Platforms
Connect TickerDB to workflow automation tools. No code required — just configure HTTP requests with your API key.
Web Frameworks
Use the SDKs above in your web framework of choice. We have guides for the most popular ones.