# TickerDB

> The categorical intelligence database for every tradable ticker. 12,000+ assets. 5 years of history. Pre-computed, queryable, built for AI.

For complete API documentation including all endpoints, parameters, response fields, and categorical bands, see: https://tickerdb.com/llms-full.txt

TickerDB provides pre-computed, categorical market data designed for LLMs and AI agents. Every response contains verifiable facts 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

## Coverage

- Asset Classes: US Stocks, Crypto, ETFs
- Tickers: 12,000+
- History: 5 years
- Timeframes: Daily, Weekly
- Update Frequency: End-of-day (EOD)
- Response Format: JSON
- Authentication: Bearer token

## Core Endpoints (The Four Doors)

- GET /v1/summary/{ticker} — Full categorical snapshot for a single asset. Supports 4 modes: latest (no params), historical snapshot (date param), date range (start/end params), and event lookups (field/band params with optional cross-asset correlation).
- GET /v1/search — Query the database with arbitrary multi-field filters. Accepts a JSON array of {field, op, value} filter objects. Supports eq, neq, in, gt, gte, lt, lte operators. Supports a `fields` param to select which columns to return (JSON array or comma-separated), dramatically reducing token usage. Call /v1/schema/fields first to discover available fields.
- GET /v1/schema/fields — Returns all queryable fields with their types, valid values, and descriptions. Always free (0 credits). Call this before using search to discover what you can filter on.
- GET /v1/watchlist — Summaries for saved tickers with field-level change detection. Also: POST (add tickers), DELETE (remove tickers), GET /v1/watchlist/changes (state diffs).

## Supporting Endpoints

- GET/POST/PUT/DELETE /v1/webhooks — Push notifications for watchlist changes
- GET /v1/account — Plan tier, limits, and current usage
- GET/POST /v1/team — Team management for commercial plans

## Summary Modes

The summary endpoint handles four use cases based on parameters:

1. Latest: GET /v1/summary/AAPL — current categorical snapshot (from cache)
2. Historical: GET /v1/summary/AAPL?date=2024-06-15 — snapshot for a specific date
3. Date range: GET /v1/summary/AAPL?start=2024-01-01&end=2024-12-31 — array of snapshots
4. Events: GET /v1/summary/AAPL?field=rsi_zone&band=deep_oversold — band transition events with aftermath performance data

Cross-asset correlation (events mode): GET /v1/summary/AAPL?field=rsi_zone&band=deep_oversold&context_ticker=SPY&context_field=trend_direction&context_band=downtrend

## Band Stability Metadata

Every categorical band field includes a sibling `_meta` object describing how stable the current value is. Stability categories: fresh, holding, established, volatile. Plus and Pro tiers receive the full metadata.

## MCP Integration

TickerDB exposes all endpoints as MCP tools. Connect to Claude Desktop, Cursor, or any MCP client.

## SDKs

- Python: tickerdb (pip install tickerdb)
- JavaScript/TypeScript: tickerdb (npm install tickerdb)
- Go: github.com/tickerdb/tickerdb-go

## Pricing

- Free: $0/month — 250 req/day, 3 search filters, latest-only history
- Plus: $29/month — 50K req/day, 5 search filters, 2 years of history
- Pro: $79/month — 100K req/day, 10 search filters, 5 years of history
- Commercial Plus: $149/month — 250K req/day, 3 team seats
- Commercial Pro: $349/month — 500K req/day, 10 team seats
- Beta: All users get Pro-tier access free during beta

## Documentation

- [Overview](https://tickerdb.com/docs)
- [Authentication](https://tickerdb.com/docs/authentication)
- [Summary Endpoint](https://tickerdb.com/docs/summary)
- [Search Endpoint](https://tickerdb.com/docs/search)
- [Schema Endpoint](https://tickerdb.com/docs/schema)
- [Watchlist Endpoint](https://tickerdb.com/docs/watchlist)
- [Account Endpoint](https://tickerdb.com/docs/account)
- [Webhooks](https://tickerdb.com/docs/webhooks)
- [Categorical Bands Reference](https://tickerdb.com/docs/bands)
- [Common Parameters](https://tickerdb.com/docs/parameters)
- [Rate Limits](https://tickerdb.com/docs/rate-limits)
- [Errors & Caching](https://tickerdb.com/docs/errors)
- [Pricing](https://tickerdb.com/pricing)
- [FAQ](https://tickerdb.com/faq)

## Pages

- [Use Cases — End-to-end agent workflows](https://tickerdb.com/use-cases)
- [Stock Market API for Agents](https://tickerdb.com/stock-market-api)
- [Blog](https://tickerdb.com/blog)
- [Competitor Comparisons](https://tickerdb.com/vs)

## Integration Guides

- [MCP Integration](https://tickerdb.com/mcp)
- [Claude Desktop & Claude Code](https://tickerdb.com/claude)
- [Cursor](https://tickerdb.com/cursor)
- [Windsurf](https://tickerdb.com/windsurf)
- [OpenClaw](https://tickerdb.com/openclaw)
- [LangChain](https://tickerdb.com/langchain)
- [LlamaIndex](https://tickerdb.com/llamaindex)
- [AutoGen](https://tickerdb.com/autogen)
- [CrewAI](https://tickerdb.com/crewai)
- [Vercel AI SDK](https://tickerdb.com/vercel-ai)
- [OpenAI GPTs](https://tickerdb.com/openai-gpts)
- [n8n](https://tickerdb.com/n8n)
- [Zapier](https://tickerdb.com/zapier)
- [Python](https://tickerdb.com/python)
- [Node.js](https://tickerdb.com/node)
- [Go](https://tickerdb.com/go)
- [Next.js](https://tickerdb.com/nextjs)
- [FastAPI](https://tickerdb.com/fastapi)
- [Django](https://tickerdb.com/django)
- [Flask](https://tickerdb.com/flask)
- [Express](https://tickerdb.com/express)
- [Nuxt](https://tickerdb.com/nuxt)
- [SvelteKit](https://tickerdb.com/sveltekit)
- [Gin](https://tickerdb.com/gin)
- [Astro](https://tickerdb.com/astro-framework)