Financial data, one API.

01Quick start

Every endpoint is a plain GET that returns JSON. A Lumid PAT is required — pass it as Authorization: Bearer <pat>. Anonymous requests get 401. The authed tier is 100 req/min.

curl https://kv.run:5000/symbols/AAPL

curl "https://kv.run:5000/ohlc/AAPL?interval=1d"

curl "https://kv.run:5000/quotes?symbols=AAPL,BTCUSD"

websocat -H="Authorization: Bearer $TOKEN" \
  wss://kv.run:5000/ws/quotes

curl "https://kv.run:5000/screener?sector=Technology&market_cap_min=1e12"

curl "https://kv.run:5000/kols/tweets/search?q=earnings+beat"

curl "https://kv.run:5000/news/latest?category=general&limit=20"

curl -L "https://kv.run:5000/kols/media/by-url?u=<twitter-cdn-url>"

02Surface

Endpoints are grouped by data domain. Open any group in the OpenAPI spec or the guide for schemas and example payloads.

03Realtime

Three streams over the same hub: tick prices, news articles, KOL tweets. Both WSS /ws/quotes (bidirectional, subscribe-by-symbol) and GET /quotes/stream (SSE) are supported; WSS /ws/news is a news-only variant. Authentication via Lumid PAT (or X-API-Key).

Tier and lag are exposed live at GET /freshness (realtime.by_source.{p50,p95,p99}_ms).

04Authentication

A Lumid PAT is required on every route — anonymous requests return 401. Auth goes through Lumid identity introspection; bring a Lumid PAT (lm_pat_live_… / rm_pat_live_…) or an RS256 JWT. Authed tier: 100 req/min.

# Bring your Lumid PAT (lm_pat_live_… / rm_pat_live_…) or JWT.
curl -H "Authorization: Bearer $LUMID_TOKEN" \
     https://kv.run:5000/symbols/AAPL

# Or via X-API-Key header — same effect.
curl -H "X-API-Key: $LUMID_TOKEN" \
     "https://kv.run:5000/quotes?symbols=AAPL"

05MCP — for agents

Every query is also a Model Context Protocol tool, so an agent can pull OHLC, fundamentals, holdings, or a real-time quote without learning a separate HTTP shape.

# Streamable-HTTP transport (MCP 2025-03-26, recommended):
curl -X POST https://kv.run:5000/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Read tools: symbols_search, symbol_get, universe_list, ohlc, fundamentals_latest, fundamentals_history, news_for_symbol, holders_top, price_target, freshness, get_quote, get_quotes.
Write & discovery tools: catalog_ingress, catalog_table_profile, catalog_table_schema, catalog_lineage_run, catalog_lineage_row, catalog_sources, ingest_typed, ingest_adapter.

06Ingress — write surface

The read API is paired with an ingress surface. Partners and agents push data with a Lumid PAT (per-role allowlist); the server stamps provenance and exposes the lineage chain back at /catalog/lineage/*. One call discovery: GET /catalog/ingress.

Full guide: INGRESS.md. MCP tools for AI agents: catalog_ingress, catalog_table_schema, ingest_typed, ingest_adapter, catalog_lineage_run, catalog_lineage_row, catalog_sources.

07Refresh cadence

08Conventions