Finnhub Data Parser & API

Finnhub is a real-time financial market data provider covering global stocks, forex, crypto, company fundamentals and market news, and StockAPIS extracts its data — live quotes, company profiles, financial statements, news headlines and sentiment — through a single unified REST API. Finnhub offers an official public REST and WebSocket API, and StockAPIS normalizes it to the same schema you use for every other source, so you query Finnhub, Polygon and Alpha Vantage the same way without maintaining separate integrations.

Platform Overview

Market Position

• A widely adopted developer-first market data API serving stocks, forex and crypto worldwide
• Coverage spans global equities across 60+ exchanges plus forex pairs and major crypto symbols
• Strong on alternative datasets — company news, social and news sentiment, earnings and economic calendars
• Official public REST + WebSocket API, complemented by StockAPIS’s unified normalization

Data Coverage

StockAPIS exposes the full Finnhub data surface:

• Real-time quotes — current price, daily change, percent change, open, high, low and previous close
• Company profiles — name, exchange, industry, market cap, share float and identifiers
• Fundamentals — income statement, balance sheet and cash-flow data on annual and quarterly frequencies
• Market & company news — categorized headlines with source, URL, summary and timestamps
• Sentiment — news and social sentiment scores per symbol
• Forex & crypto — currency exchange rates, forex symbols and crypto candles across supported venues
• Economic data — economic indicators and calendar events

Quick Start

import stockapis
 
client = stockapis.Client(api_key="your-api-key")
 
# Real-time quote for a US-listed stock
quote = client.finnhub.get_quote(symbol="AAPL")
print(f"Apple: ${quote['currentPrice']}  ·  {quote['percentChange']}%")

const { StockAPIS } = require("stockapis");
const client = new StockAPIS({ apiKey: "your-api-key" });
 
// Latest market news with sentiment
const news = await client.finnhub.getCompanyNews({
  symbol: "MSFT",
  from: "2024-01-01",
  to: "2024-01-15",
});
console.log(news[0].headline, news[0].source);

Sample API Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "companyName": "Apple Inc.",
    "currentPrice": 185.92,
    "change": 2.15,
    "percentChange": 1.17,
    "open": 183.5,
    "high": 186.25,
    "low": 182.8,
    "previousClose": 183.77,
    "marketCap": 2900000000000,
    "news": [
      {
        "headline": "Apple unveils new product lineup",
        "source": "Reuters",
        "url": "https://example.com/article",
        "datetime": 1705334400,
        "sentiment": 0.62
      }
    ],
    "timestamp": 1705334400
  },
  "metadata": { "source": "finnhub", "timestamp": "2024-01-15T10:30:00.000Z" }
}

Use Cases

• Market dashboards — power real-time quote, fundamentals and news widgets from one normalized feed
• News & sentiment trading — surface company headlines and sentiment scores to drive event-based strategies
• Quant research — pull fundamentals, earnings and economic calendars for screening and backtesting
• Cross-source aggregation — blend Finnhub data with Polygon, Alpha Vantage and other vendors on one schema

Frequently Asked Questions

Does Finnhub have an official API? Yes — Finnhub provides an official public REST and WebSocket API covering quotes, fundamentals, news and sentiment. StockAPIS wraps it in a unified schema so Finnhub data matches every other source you pull.

What data can I get from Finnhub through StockAPIS? Real-time stock quotes, company profiles, financial statements, market and company news, news/social sentiment, forex and crypto rates, plus economic indicators and calendar events.

Can I stream Finnhub data in real time? Yes — Finnhub offers WebSocket streaming for trades and quotes, and StockAPIS exposes real-time updates alongside its normalized REST responses.

Related Resources

• API reference
• Financial data APIs