# TickerAPI

> Financial APIs built for AI agents. Pre-computed, categorical market intelligence — no OHLCV parsing, no infrastructure.

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

TickerAPI 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.tickerapi.ai/v1

## Coverage

- Asset Classes: US Stocks, Crypto, ETFs
- Timeframes: Daily, Weekly
- Update Frequency: End-of-day (EOD)
- Response Format: JSON
- Authentication: Bearer token

## Endpoints

- GET /v1/summary/{ticker} — Full factual snapshot for a single asset (trend, momentum, volatility, volume, support/resistance, fundamentals)
- GET /v1/compare — Side-by-side comparison of 2-50 assets
- GET /v1/watchlist — Batch check multiple tickers for portfolio monitoring
- GET /v1/watchlist/changes — Field-level state changes since last pipeline run
- GET /v1/events — Historical band transition events with aftermath performance
- GET /v1/assets — Full supported asset list with metadata
- GET /v1/list/sectors — List all sectors with asset counts (free, no rate limit)
- GET /v1/account — Check plan tier, limits, and current usage
- GET /v1/scan/breakouts — Find assets testing or breaking key support/resistance levels
- GET /v1/scan/oversold — Find assets in oversold conditions with historical context
- GET /v1/scan/overbought — Find assets in overbought conditions with historical context
- GET /v1/scan/unusual-volume — Find assets trading at abnormal volume levels
- GET /v1/scan/valuation — Find stocks at historically abnormal valuations
- GET /v1/scan/insider-activity — Find stocks with significant insider buying or selling
- GET/POST/PUT/DELETE /v1/webhooks — Manage webhook subscriptions for push notifications

## 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. The `_meta` object contains stability, periods_in_current_state, flips_recent, flips_lookback, and timeframe. Plus and Pro tiers receive the full metadata object including the stability label. Stability metadata also appears on events, scans, and watchlist changes.

## MCP Integration

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

## SDKs

- Python: tickerapi-sdk-python
- JavaScript/TypeScript: tickerapi-sdk-js
- Go: tickerapi-sdk-go

## Pricing

- Free: $0/month — 250 req/day, 100 req/hr
- Plus: $25/month (individual), $100/month (commercial) — 50K-250K req/day
- Pro: $50/month (individual), $200/month (commercial) — 100K-500K req/day
- Beta: All users get Pro-tier access free during beta

## Documentation

- [Overview](https://tickerapi.ai/docs)
- [Authentication](https://tickerapi.ai/docs/authentication)
- [Summary Endpoint](https://tickerapi.ai/docs/summary)
- [Compare Endpoint](https://tickerapi.ai/docs/compare)
- [Watchlist Endpoint](https://tickerapi.ai/docs/watchlist)
- [Events Endpoint](https://tickerapi.ai/docs/events)
- [Assets Endpoint](https://tickerapi.ai/docs/assets)
- [Sectors Endpoint](https://tickerapi.ai/docs/sectors)
- [Account Endpoint](https://tickerapi.ai/docs/account)
- [Webhooks](https://tickerapi.ai/docs/webhooks)
- [Breakouts Scan](https://tickerapi.ai/docs/scan-breakouts)
- [Oversold Scan](https://tickerapi.ai/docs/scan-oversold)
- [Overbought Scan](https://tickerapi.ai/docs/scan-overbought)
- [Unusual Volume Scan](https://tickerapi.ai/docs/scan-unusual-volume)
- [Valuation Scan](https://tickerapi.ai/docs/scan-valuation)
- [Insider Activity Scan](https://tickerapi.ai/docs/scan-insider-activity)
- [Categorical Bands Reference](https://tickerapi.ai/docs/bands)
- [Common Parameters](https://tickerapi.ai/docs/parameters)
- [Rate Limits](https://tickerapi.ai/docs/rate-limits)
- [Errors & Caching](https://tickerapi.ai/docs/errors)
- [Pricing](https://tickerapi.ai/pricing)
- [FAQ](https://tickerapi.ai/faq)

## Pages

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

## Integration Guides

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