TickerDB Docs
Market context for agents.
TickerDB provides pre-computed market context that improves reasoning and reduces token usage. No OHLCV, no raw indicators, and no prompt-time math.
oversold, not RSI: 24). Supporting metadata like durations, percentiles, and support/resistance context stays compact and explicit.
Base URL
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, 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/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
- 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
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.