Stocks

Equity fundamentals, company details, news, SEC filings, stock market overview, and real-world assets (RWA).

The Stocks endpoints provide equity fundamentals, company details, stock news, SEC filings, stock market overview, and real-world asset data. For shared conventions (envelope, pagination, rate limits, credits, errors) see Conventions. For authentication see Authentication.

Stock {symbol} accepts both bare tickers and market-qualified tickers, such as NVDA and NVDA-US.

Stock market overview

GET /stock/overview -- sector heatmap. Credits: 1

Param	Required	Default	Notes
`category`	no	--	Sector slug
`market`	no	--	`US` · `HK` · `JP` · `KR`

Example response for GET /stock/overview?market=US:

{
  "code": "0",
  "msg": "success",
  "data": {
    "market": "US",
    "limitPerCategory": 40,
    "categories": [
      {
        "category": null,
        "label": null,
        "market": null,
        "items": [
          {
            "assetId": 658756,
            "symbol": "NVDA",
            "name": "NVIDIA Corporation",
            "market": "US",
            "stockCode": "NVDA-US",
            "price": 211.96,
            "priceUsd": 211.96,
            "change24h": -0.24942350228246085,
            "marketCap": 5142500074097.08,
            "volume24h": 124796251,
            "sector": "Electronic Technology",
            "industry": "Semiconductors",
            "priceUpdatedAt": "2026-07-16T03:24:09.063Z"
          }
        ]
      }
    ]
  }
}

Stock fundamentals

GET /stock/{symbol}/fundamentals -- quote overview, key metrics, analyst ratings, and financial statements. Credits: 1

Example response for GET /stock/NVDA-US/fundamentals:

{
  "code": "0",
  "msg": "success",
  "data": {
    "asset": {
      "id": 658756,
      "symbol": "NVDA",
      "stockCode": "NVDA-US",
      "displaySymbol": "NVDA",
      "name": "NVIDIA Corp",
      "market": "US",
      "currency": "USD",
      "sector": "Electronic Technology",
      "industry": "Semiconductors",
      "country": "US"
    },
    "source": {
      "provider": "finnhub",
      "symbol": "NVDA",
      "updatedAt": "2026-07-16T03:23:27.551Z",
      "freshness": "fresh"
    },
    "overview": {
      "quote": {
        "price": 212.5,
        "priceUsd": 212.5,
        "change": 0.3305,
        "changePercent": 0.3305,
        "high": 213.81,
        "low": 206.04,
        "timestamp": "2026-07-16T03:23:27.295Z"
      },
      "overviewMetrics": [
        { "key": "marketCap", "label": "Market Cap", "value": "5.14T", "valueUsd": "$5.14T" },
        { "key": "revenue", "label": "Revenue", "value": "81.61B", "valueUsd": "$81.61B" },
        { "key": "netIncome", "label": "Net Income", "value": "58.32B", "valueUsd": "$58.32B" }
      ],
      "analystRatings": [
        { "label": "Strong Buy", "value": "24" },
        { "label": "Buy", "value": "39" },
        { "label": "Hold", "value": "4" }
      ]
    },
    "financials": {
      "incomeStatement": [],
      "balanceSheet": [],
      "cashFlowStatement": []
    },
    "errors": [
      { "section": "overview", "endpoint": "SOCIAL_SENTIMENT", "message": "Finnhub returned no data" }
    ]
  }
}

Company details

GET /stock/{symbol}/company -- executives, major shareholders, fund holdings, and insider transactions. Credits: 1

Example response for GET /stock/NVDA-US/company:

{
  "code": "0",
  "msg": "success",
  "data": {
    "asset": {
      "id": 658756,
      "symbol": "NVDA",
      "stockCode": "NVDA-US",
      "displaySymbol": "NVDA",
      "name": "NVIDIA Corp",
      "market": "US",
      "currency": "USD",
      "sector": "Electronic Technology",
      "industry": "Semiconductors",
      "country": "US"
    },
    "source": {
      "provider": "finnhub",
      "symbol": "NVDA",
      "updatedAt": "2026-07-16T03:23:27.551Z",
      "freshness": "fresh"
    },
    "company": {
      "executives": [
        {
          "name": "Mr. Jen-Hsun Huang",
          "role": "President, Chief Executive Officer, Director",
          "age": "62",
          "since": "1993",
          "compensation": "$49,866,251",
          "compensationUsd": "$49,866,251"
        }
      ],
      "shareholders": [
        {
          "name": "Vanguard Capital Management, LLC",
          "stake": "1.54B",
          "change": "+1.54B",
          "reportedAt": "2026-03-31"
        }
      ],
      "funds": [
        {
          "name": "Vanguard Total Stock Market Index Fund",
          "stake": "733.31M",
          "change": "+3.12M",
          "weight": "6.44%"
        }
      ],
      "insiderTransactions": [
        {
          "name": "COXE TENCH",
          "transactionDate": "2026-07-01",
          "filingDate": "2026-07-06",
          "transactionCode": "G",
          "shares": "25.17M",
          "change": "-500.00K",
          "price": "$0.00",
          "value": "$0"
        }
      ]
    },
    "errors": [
      { "section": "overview", "endpoint": "SOCIAL_SENTIMENT", "message": "Finnhub returned no data" }
    ]
  }
}

Stock news

GET /stock/{symbol}/news -- news for a single stock. Credits: 1

Param	Required	Default	Notes
`page`	no	`1`	1-based
`limit`	no	`20`	1-100

Example response for GET /stock/NVDA-US/news?page=1&limit=2:

{
  "code": "0",
  "msg": "success",
  "data": {
    "asset": {
      "id": 658756,
      "symbol": "NVDA",
      "stockCode": "NVDA-US",
      "name": "NVIDIA Corporation",
      "market": "US"
    },
    "source": {
      "provider": "FINNHUB",
      "readSource": "db",
      "freshness": "stale",
      "sourceSymbol": "NVDA",
      "lastSuccessAt": "2026-07-15T00:28:48.765Z",
      "lastBackfilledTo": "2026-07-15T00:00:00.000Z"
    },
    "items": [
      {
        "id": 1406942,
        "source": "FINNHUB",
        "title": "Why Goldman Sachs Stock Jumped Today",
        "summary": "Corporate dealmaking is booming.",
        "tags": ["company"],
        "concepts": ["GS"],
        "url": "https://finnhub.io/api/news?id=6f3e833ad20a21a149d11b447b5d9ecef2cafc333475262e798f24c7989547d5",
        "publishedAt": "2026-07-15T03:20:02.000Z",
        "publisher": "Yahoo",
        "assets": [
          { "id": 658756, "symbol": "NVDA", "name": "NVIDIA Corporation", "type": "STOCK" }
        ],
        "translationReady": false,
        "translationStatus": "missing",
        "assetLinked": true
      }
    ],
    "page": 1,
    "limit": 2,
    "hasMore": true,
    "errors": []
  }
}

SEC filings

GET /stock/{symbol}/sec-filings -- 10-K / 10-Q / 8-K and other filings. Credits: 2

Param	Required	Default	Notes
`from`	no	--	Start date in `YYYY-MM-DD` format
`to`	no	--	End date in `YYYY-MM-DD` format
`forms`	no	--	Comma-separated form types, such as `10-K,10-Q`
`limit`	no	`20`	1-50

Example response for GET /stock/NVDA-US/sec-filings?forms=10-K,10-Q&limit=2:

{
  "code": "0",
  "msg": "success",
  "data": {
    "source": {
      "provider": "db",
      "symbol": "NVDA",
      "from": "2025-07-16",
      "to": "2026-07-16",
      "updatedAt": "2026-07-15T05:50:28.063Z"
    },
    "items": [
      {
        "formType": "10-Q",
        "filingDate": "2026-05-20",
        "acceptedDate": "2026-05-20",
        "accessionNo": "0001045810-26-000052",
        "reportUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000052/nvda-20260426.htm",
        "description": "10-Q"
      },
      {
        "formType": "10-K",
        "filingDate": "2026-02-25",
        "acceptedDate": "2026-02-25",
        "accessionNo": "0001045810-26-000021",
        "reportUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000021/nvda-20260125.htm",
        "description": "10-K"
      }
    ],
    "count": 2,
    "limit": 2
  }
}

RWA

GET /rwa -- real-world / tokenized assets. Credits: 1

Param	Required	Default	Notes
`type`	no	--	`ALL` · `CRYPTO` · `STOCK` · `ETF` · `FOREX` · `COMMODITY`
`page`	no	`1`
`limit`	no	`20`	1-100
`sort`	no	--	Sort field
`order`	no	--	`asc` · `desc`

Example response for GET /rwa?type=STOCK&limit=2:

{
  "code": "0",
  "msg": "success",
  "data": {
    "items": [
      {
        "rwaId": "687899c0cbbf471de3366fae",
        "rank": 2,
        "symbol": "NVDA",
        "name": "Nvidia Corp",
        "slug": "nvidia",
        "assetType": 1,
        "rwaPrice": 211.264,
        "avgTokenPrice": 211.70972511101834,
        "changePct": 0.330500472144,
        "marketCap": 5117025344000,
        "volume": 21362903498.816,
        "tokenMcap": 191173688.8209466,
        "tokenVol": 45947403.93386441,
        "marketStatus": "closed",
        "tokenList": [
          {
            "name": "NVIDIA tokenized stock (xStock)",
            "cryptoId": 36992,
            "slug": "nvidia-tokenized-stock-xstock",
            "symbol": "NVDAX"
          }
        ],
        "linkedAssetId": 658756,
        "linkedAssetType": "STOCK",
        "linkedAssetSymbol": "NVDA",
        "updatedAt": "2026-07-16T03:20:12.697Z"
      }
    ],
    "page": 1,
    "limit": 2,
    "total": 1992,
    "hasMore": true
  }
}