How do I look up a single company's market cap?
GET /api/v1/market-cap?symbol=AAPL returns the latest market cap, company name, sector, and currency for that ticker.
Market Cap API
Rankings
Trend Analytics
Multi-Symbol Compare
Market cap data. Ranked and compared.
Look up any ticker, rank companies by market cap with sector and range filters, or compare multiple symbols side by side — all from a deterministic snapshot dataset.
Symbol · lookupTop 50 · rankingsTrend · analyticsCompare · multi-symbol
Look up any ticker, instantly.
This calls the live Market Cap API in snapshot mode. Switch symbols to see the latest market capitalization.
Request builder
Symbol in, market cap out.
GET /market-cap
Rankings and comparison
GET /top returns ranked companies with sector and range filters. GET /compare returns multiple symbols side by side in one call.
Output preview
Live response from the API, plus the exact request to reproduce it.
Loading live market cap...
Why Market Cap API
Valuation, ranked and compared.
Snapshot always available
Look up any symbol in the snapshot dataset without depending on a live provider key.
Top-cap rankings
GET /top ranks companies by market cap with sector, minMarketCap/maxMarketCap, and sort controls.
Trend analytics
GET /trend returns first/latest values, absolute change, percent change, and trend direction over a period.
Historical series
GET /history returns a synthetic historical market-cap series for one symbol with date-range filtering.
Multi-symbol comparison
GET /compare returns found and missing records for a comma-separated symbols list in one call.
Catalog discovery
GET /catalog returns supported modes and the full symbol inventory for building dynamic pickers.
/api/v1/market-cap
Endpoints, at a glance.
Symbol lookup, history, trend analytics, top rankings, multi-symbol comparison, and catalog discovery — all GET, snapshot mode always available.
GET/api/v1/market-cap
Symbol lookup
Single-symbol market cap in snapshot or live mode. Requires symbol.
GET/api/v1/market-cap/history
History
Synthetic historical market-cap series for one symbol, with period and date-range filtering.
GET/api/v1/market-cap/trend
Trend
Summarized trend analytics — first/latest value, absolute and percent change, direction.
GET/api/v1/market-cap/top
Top rankings
Ranked companies by market cap, with sector, range, sort, and limit controls.
GET/api/v1/market-cap/compare
Compare
Multi-symbol comparison from the snapshot dataset. Requires symbols.
GET/api/v1/market-cap/catalog
Catalog
Supported modes and the full symbol inventory.
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | yes* | Ticker for the primary lookup endpoint, e.g. AAPL. |
| symbols | string | yes* | Comma-separated tickers for /compare, e.g. AAPL,MSFT,NVDA. |
| mode | string | no | snapshot (default) or live. |
| period | string | no | 1m, 3m, 6m, 1y, 3y, or 5y for history/trend. |
| limit | integer | no | Top list size for /top. 1 to 50. |
| sector | string | no | Exact sector filter for /top, e.g. Technology. |
| minMarketCap / maxMarketCap | number | no | Inclusive market-cap bounds for /top. |
| sort | string | no | desc (default) or asc for /top. |
Error reference
Failures you can plan for.
Snapshot mode never triggers a 503 — only requesting mode=live without configured provider credentials does.
400Validation Error
Invalid query parameters or a missing required symbol/symbols value.
401Authentication Error
Missing or invalid gateway API key. Send x-api-key or api_key with every request.
404Not Found
Symbol absent from the snapshot dataset, or an unknown route.
429Rate Limit Error
More than 200 requests in a 15-minute window per IP.
502Processing Error
Live provider request failed or returned an invalid payload.
503Feature Gated
mode=live requested without live provider credentials configured server-side.
Example not-found response (404)
{
"success": false,
"error": "Symbol not found in snapshot dataset: XYZ",
"correlationId": "1784851502441-c0x4md9l8"
}FAQ
API questions developers ask first.
Can I rank companies by market cap?
Yes. GET /top returns a ranked list with optional sector, minMarketCap/maxMarketCap range filters, sort direction, and a configurable limit (1-50).
How do I compare multiple companies?
GET /compare accepts a comma-separated symbols list and returns found records plus any symbols missing from the snapshot dataset.
What's the difference between snapshot and live mode?
Snapshot mode is always available and returns deterministic values from the cached dataset. Live mode calls a live provider and requires provider credentials — pass mode=live to try it.
How do I authenticate requests?
Send your Datpaq API key as an x-api-key header or an api_key query parameter. Keys are created in the Datpaq dashboard and a free tier is included.
Add market cap data in one request.
Symbol lookup, top-cap rankings, trend analytics, and multi-symbol comparison, backed by a deterministic snapshot dataset.