TickerDB Docs
Pre-computed market data for agents.
TickerDB provides pre-computed financial data that improves reasoning and reduces token usage, plus daily OHLCV when an exact price series is needed.
Built for AI
Core market-state signals are expressed as categorical bands (e.g. oversold, not RSI: 24). Supporting metadata like durations, percentiles, and support/resistance context stays compact and explicit.
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
The core read surface is Summary, OHLCV, Search, Schema, and Watchlist. Webhooks and Account round out delivery and account management.
| Endpoint | Example Prompt | Use Case |
|---|---|---|
GET /v1/summary/:ticker | "How's AAPL looking?" | Single-asset intelligence (latest, historical, date range, events) |
GET /v1/ohlcv/:ticker | "Give me ZECUSD daily closes" | Paginated daily candles for exact returns, charts, and backtests |
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 response is grounded in observed market data
- 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
- Categorical first, prices when needed — compact intelligence by default, paginated daily OHLCV for exact calculations
- 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 Integrations
TickerDB has a hosted remote MCP server for Claude, ChatGPT, Cursor, and other Streamable HTTP clients.
Connect an MCP client
Use the dedicated MCP Integration guide for the server URL, OAuth flow, current client setup steps, configuration examples, and troubleshooting.
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.