TickerAPI Docs
Factual market intelligence for AI agents & MCP clients
TickerAPI 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.tickerapi.ai/v1
What TickerAPI 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 | Strategy |
|---|---|---|
GET /v1/scan/oversold | "What is oversold today?" | Mean reversion / bounce |
GET /v1/scan/overbought | "What is overbought today?" | Momentum / mean reversion |
GET /v1/scan/breakouts | "What's breaking out?" | Momentum / breakout |
GET /v1/scan/unusual-volume | "What has unusual activity?" | Volume anomaly |
GET /v1/scan/valuation | "What's historically cheap?" | Value / mean reversion |
GET /v1/scan/insider-activity | "Any insider buying?" | Insider signal |
GET /v1/summary/{ticker} | "How's AAPL looking?" | Single-asset evaluation |
GET /v1/compare | "Compare NVDA vs AMD" | Multi-asset comparison |
GET /v1/watchlist | "Watch my stocks" | Portfolio monitoring |
GET /v1/watchlist/changes | "What changed on my watchlist?" | Watchlist state changes |
GET /v1/events | "When was AAPL last oversold?" | Historical band transitions |
POST /v1/webhooks | "Push changes to my URL" | Webhook notifications |
GET /v1/assets | "What can I look at?" | Asset discovery |
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
# Find oversold stocks (Free tier)
curl https://api.tickerapi.ai/v1/scan/oversold \
-H "Authorization: Bearer YOUR_API_KEY" # Get a full summary for AAPL (Plus+)
curl https://api.tickerapi.ai/v1/summary/AAPL \
-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 | tickerapi | npm install tickerapi |
| Python | tickerapi | pip install tickerapi |
| Go | tickerapi-go | go get github.com/tickerapi/tickerapi-go |
MCP & Agent Frameworks
TickerAPI 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 TickerAPI 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.