{
  "schemaVersion": "1.0",
  "provider": {
    "id": "finnhub",
    "name": "Finnhub API",
    "provider": "Finnhub",
    "category": "market-data",
    "status": "active",
    "summary": "Real-time and historical market data for stocks, forex, and crypto. Generous free tier for US stocks; premium endpoints (e.g. historical candles) require paid plans.",
    "homepage": "https://finnhub.io/",
    "officialDocs": "https://finnhub.io/docs/api",
    "baseUrl": "https://finnhub.io/api/v1",
    "auth": "API key via `token` query param or `X-Finnhub-Token` header",
    "versioning": "v1 in URL path",
    "resourceGroups": [
      "Stock quotes",
      "Company fundamentals",
      "News",
      "Economic data",
      "Crypto/Forex"
    ],
    "pagination": "Varies by endpoint; cursor or limit/offset",
    "errors": "HTTP 429 on rate limit; 403 on premium endpoints with free key",
    "webhooks": "Not supported; use WebSocket for streaming",
    "sdks": [
      "finnhub-python (official)",
      "finnhub-go",
      "finnhub-ruby"
    ],
    "pricing": "Free tier: 60 calls/min; paid tiers raise limits",
    "rateLimit": "60 calls/min free; 30 req/sec global cap; HTTP 429 when exceeded",
    "formats": [
      "JSON"
    ],
    "protocols": [
      "REST",
      "WebSocket"
    ],
    "bestFor": [
      "US stock quotes",
      "Company fundamentals",
      "Real-time price streaming"
    ],
    "cautions": [
      "/stock/candle (historical OHLCV) returns 403 on free tier.",
      "Free tier covers US stocks well; international coverage is limited.",
      "WebSocket limited to 1 concurrent connection per key."
    ],
    "tags": [],
    "verifiedAt": "2026-10-15",
    "sourceUrls": [
      "https://finnhub.io/docs/api",
      "https://finnhub.io/pricing"
    ],
    "mutableFacts": [
      {
        "key": "base-url",
        "label": "Base URL",
        "value": "https://finnhub.io/api/v1",
        "sourceUrl": "https://finnhub.io/docs/api",
        "verifiedAt": "2026-10-15"
      },
      {
        "key": "authentication",
        "label": "Authentication",
        "value": "API key via token query param or X-Finnhub-Token header",
        "sourceUrl": "https://finnhub.io/docs/api",
        "verifiedAt": "2026-10-15"
      },
      {
        "key": "pricing",
        "label": "Pricing",
        "value": "Free tier: 60 calls/min; paid tiers raise limits",
        "sourceUrl": "https://finnhub.io/pricing",
        "verifiedAt": "2026-10-15"
      },
      {
        "key": "rate-limits",
        "label": "Rate limits",
        "value": "60 calls/min free; 30 req/sec global cap",
        "sourceUrl": "https://finnhub.io/pricing",
        "verifiedAt": "2026-10-15"
      }
    ],
    "humanUrl": "/api-atlas/apis/finnhub/",
    "jsonUrl": "/api-atlas/api/providers/finnhub.json"
  }
}