Frequently asked questions.
Common questions about TickerDB, the data, and how it works. For billing and plan questions, see the pricing page.
What is TickerDB?
TickerDB is a categorical intelligence database for every tradable ticker — 12,000+ stocks, crypto, and ETFs with 5 years of history. Every field is pre-computed into categorical bands your agent already understands ("momentum_rsi_zone": "oversold" instead of raw "rsi": 27.4). Query it via REST API, MCP, or SDK — the database is the product.
Who is TickerDB for?
Developers building with AI agents, MCP, or OpenClaw who need financial market context. Trading bots, stock analysis tools, portfolio assistants — any project where an LLM needs to reason about market conditions. Whether you're vibe-coding a side project or shipping a production agent.
What are the four endpoints?
Summary (/v1/summary/AAPL) — full categorical snapshot for one ticker, with optional date range and event lookups. Search (/v1/search) — arbitrary multi-field filtering across all 12,000+ tickers. Schema (/v1/schema/fields) — discover all queryable fields. Watchlist (/v1/watchlist) — monitor your saved tickers with state change detection. Plus webhooks and account management.
How does search work?
The search endpoint accepts an array of filters — each with a field name, operator, and value. For example: momentum_rsi_zone = oversold AND sector = Technology AND volume_ratio_band IN (high, extremely_high). You can sort server-side, select specific fields to return (reducing token usage), and paginate. Call /v1/schema/fields first to discover all 120+ queryable fields. SDKs include a Supabase-style query builder.
What assets does TickerDB cover?
12,000+ assets across US stocks, ETFs, and 120+ cryptocurrencies. Pass any ticker to /v1/summary/TICKER — if it returns data, it's covered. If not, you get a 404. No separate assets list endpoint needed.
How often is the data updated?
Daily after market close, refreshed at approximately 00:30 UTC. Crypto updates include weekends. Every response includes "data_status": "eod" so your agent knows the data freshness. No intraday data — TickerDB is end-of-day only.
What does "categorical" mean?
Instead of "rsi": 27.4, TickerDB returns "momentum_rsi_zone": "oversold". Every indicator is bucketed into named bands that LLMs already understand. No prompt engineering needed to explain what 27.4 means. The result: more consistent reasoning, fewer tokens, and no indicator math on your side.
How much historical data is available?
Up to 5 years depending on your plan. Free tier gets latest data only. Plus gets 2 years. Pro gets the full 5-year history. Use the summary endpoint with ?start=2024-01-01&end=2024-12-31 for date ranges, or ?field=momentum_rsi_zone&band=deep_oversold for historical event lookups with aftermath performance data.
Does TickerDB work with MCP and OpenClaw?
Yes — all endpoints are exposed as MCP tools. Connect to Claude Desktop, Cursor, Windsurf, or any MCP client. OpenClaw has a native TickerDB skill. The categorical response format maps directly into tool results with no transformation needed.
Are there SDKs?
Python, Node.js, and Go. All three include a Supabase-style query builder for search: .select('ticker', 'sector').eq('momentum_rsi_zone', 'oversold').sort('extremes_condition_percentile', 'asc').limit(10).execute(). Or just use curl — the API is simple GET requests with a Bearer token.
Do crypto tickers require special formatting?
Yes — crypto tickers use a USD suffix: BTCUSD, ETHUSD, SOLUSD. Stocks and ETFs use standard symbols.
Are fundamentals available for crypto and ETFs?
No. Fundamentals (valuation, growth, earnings, analyst consensus) are stocks only. Crypto and ETF responses omit those fields entirely. Technical data (trend, momentum, volatility, volume) is available for all asset classes.
What are the rate limits?
Free: 250 credits/day, 100/hour. Plus: 50K/day, 5K/hour. Pro: 100K/day, 10K/hour. Commercial plans go up to 500K/day. Most requests cost 1 credit. Watchlist GET costs 1 per ticker. Schema is always free (0 credits). Every response includes rate limit headers.
How does the search filter limit work?
Free tier allows up to 3 filters per search query. Plus allows 5. Pro allows 10. This is the primary upgrade lever — you start with simple queries, then need more filters as you build more sophisticated screening logic.
Is the data predictive?
No. Every field is a verifiable fact — "the RSI zone is oversold" or "the stock has been in a downtrend for 12 days." No forecasts, no recommendations, no predictions. What your agent does with those facts is up to you.
What's the difference between free and paid data?
Free gets core technical data (trend, momentum, volatility, volume) and latest-only snapshots with 3 search filters. Plus adds 2-year history, fundamentals, events with aftermath data, cross-asset correlation, and 5 search filters. Pro gets the full 5-year database with 10 search filters and all fields including stability metadata.
What about commercial plans and team seats?
If you're building a product that serves other users or generates revenue, a commercial plan is required. Commercial Plus ($149/mo, 3 seats) and Commercial Pro ($349/mo, 10 seats) include higher rate limits, team management via the /v1/team API, and commercial use rights. All plans are for internal use — redistribution requires a custom agreement.
What happens if I exceed my rate limit?
HTTP 429 with a reset timestamp and an upgrade URL. Daily limits reset at midnight UTC. Hourly limits reset at the top of each hour. Build rate-aware logic using the X-Requests-Remaining headers in every response.