Log inSign up
WebSocketFinance & Macro

Finnhub API (REST + WebSocket)

Finnhub API (REST + WebSocket) is a websocket from Finnhub providing finance & macro data. Finnhub is a financial-data API offering an economic calendar (CPI, jobs, GDP, FOMC/rate decisions) over REST plus a real-time WebSocket for trade, quote and news streams across stocks, forex and crypto. A Polymarket bot can use it to track scheduled macro releases that drive FOMC/CPI/recession markets and watch the assets that move on those prints in real time.

At a glance

ProviderFinnhub
TypeWebSocket
CategoryFinance & Macro
Real-timeYes — streaming
AuthAPI key
PricingFree tier (60 calls/min, real-time US data); paid plans from ~$49.99/mo per market bundle — Free: $0, ~60 API calls/min, real-time US stock data, economic calendar, WebSocket up to ~50 symbols, Paid market bundles: from ~$49.99/mo each (e.g. real-time international markets, deeper history), All-in-One / higher tiers: bundled data with fewer limits, custom enterprise pricing

What data it provides

  • Economic calendar: recent and upcoming macro releases (CPI, NFP/jobs, GDP, FOMC rate decisions, central-bank events) with actual/estimate/prior values and impact tags
  • Real-time WebSocket trade/quote stream for US stocks, forex and crypto symbols
  • Real-time news WebSocket feed (market and company news)
  • Quotes, candles and company fundamentals across global equities
  • Earnings calendar, IPO calendar and analyst estimates
  • Economic indicator codes endpoint (economic_code) listing supported series

Features

  • Free tier ~60 REST calls/minute; higher limits on paid plans
  • WebSocket real-time streaming: ~50 symbols on free tier, unlimited on paid
  • Economic calendar refreshed roughly every 6 hours; covers US/EU/UK/Japan and 50+ high-impact events
  • Official SDKs/clients for Python, Go, JavaScript plus community wrappers
  • REST + WebSocket; broad coverage of stocks, forex, crypto, plus economic and alternative data
  • Deeper history and international markets gated behind paid market bundles

Links

Use it in a bot

Other finance & macro data sources

Listed, not endorsed. Pricing and capabilities change without notice — check the provider's own documentation before you depend on anything here. Browse the full data resources directory or the strategy database.
Join Discord