Finnhub website screenshot

Finnhub

With the sole mission of democratizing financial data, we are proud to offer a FREE realtime API for stocks, forex and cryptocurrency. With this API, you can access realtime market data from stock exchanges, 10 forex brokers, and 15+ crypto exchanges.

Finnhub publishes 8 APIs on the APIs.io network, including Finnhub, Company News API, Crypto API, and 5 more. Tagged areas include Financial, Market Data, Stocks, Forex, and Cryptocurrency.

The Finnhub catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Finnhub’s developer surface includes authentication, documentation, API reference, support, pricing, signup flow, and 23 more developer resources.

🌐 Visit website 📡 Source on GitHub
55.4/100 developing ▬ flat Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
8 APIs 1 MCP Servers
FinancialMarket DataStocksForexCryptocurrencyFundamentalsNewsWebSocket

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 55.4/100 · developing
Contract Quality 15.8 / 25
Developer Ergonomics 9.0 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 4.8 / 13
Governance 6.4 / 12
Discoverability 9.3 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/finnhub: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Finnhub

With the sole mission of democratizing financial data, Finnhub offers a realtime REST API for stocks, forex, and cryptocurrency, including market data, company fundamentals, eco...

Finnhub Company News API

The Company News API from Finnhub — 1 operation(s) for company news.

Finnhub Crypto API

The Crypto API from Finnhub — 3 operation(s) for crypto.

Finnhub Forex API

The Forex API from Finnhub — 3 operation(s) for forex.

Finnhub News API

The News API from Finnhub — 1 operation(s) for news.

Finnhub Quote API

The Quote API from Finnhub — 1 operation(s) for quote.

Finnhub Search API

The Search API from Finnhub — 1 operation(s) for search.

Finnhub Stock API

The Stock API from Finnhub — 5 operation(s) for stock.

Scroll for all 8

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Finnhub API

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

finnhub-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Finnhub Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Finnhub Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finnhub Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Finnhub WebSocket API

AsyncAPI specification for Finnhub's real-time streaming WebSocket APIs. A single WebSocket endpoint (wss://ws.finnhub.io) multiplexes three documented streams selected by the e...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Finnhub API Rules

6 rules · 1 errors 5 warnings

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Finnhub Authentication

apiKey · 2 schemes

SECURITY

Finnhub Domain Security

TLSv1.2

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Finnhub Agentic Access

15 operations

15 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Signup
Signup

Documentation 3

Reference material describing how the API behaves

OpenAPI
OpenAPI
 Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 AgentSkill
AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conventions
Conventions
 DataModel
DataModel

Build 5

SDKs, sample code, and the tooling you integrate with

Packages
Packages
 SDKs
SDKs
 ToolCrosswalk
ToolCrosswalk
 Postman
Postman
 GitHubOrganization
GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

RateLimits
RateLimits
 Support
Support

Commercial 4

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps
 TermsOfService
TermsOfService
 Pricing
Pricing

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Website
Website

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
aid: finnhub
name: Finnhub
description: With the sole mission of democratizing financial data, we are proud to offer a FREE realtime API for stocks,
  forex and cryptocurrency. With this API, you can access realtime market data from stock exchanges, 10 forex brokers, and
  15+ crypto exchanges.
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/finnhub.png
access: 3rd-Party
created: '2025-02-08'
modified: '2026-07-22'
position: Consumer
tags:
- Financial
- Market Data
- Stocks
- Forex
- Cryptocurrency
- Fundamentals
- News
- WebSocket
url: https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: finnhub:finnhub
  name: Finnhub
  tags:
  - Financial
  - Market Data
  - Stocks
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  properties:
  - url: https://finnhub.io/docs/api
    type: Documentation
  - url: openapi/finnhub-swagger-original.json
    type: OpenAPI
  - url: https://github.com/Finnhub-Stock-API
    type: GitHubOrg
  - url: https://finnhub.io/docs/api/websocket-trades
    type: WebSocket
  - url: https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/asyncapi/finnhub-asyncapi.yml
    type: AsyncAPI
  description: With the sole mission of democratizing financial data, Finnhub offers a realtime REST API for stocks, forex,
    and cryptocurrency, including market data, company fundamentals, economic data, and alternative datasets.
- aid: finnhub:finnhub-company-news-api
  name: Finnhub Company News API
  description: The Company News API from Finnhub — 1 operation(s) for company news.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Company News
  properties:
  - type: OpenAPI
    url: openapi/finnhub-company-news-api-openapi.yml
- aid: finnhub:finnhub-crypto-api
  name: Finnhub Crypto API
  description: The Crypto API from Finnhub — 3 operation(s) for crypto.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Crypto
  properties:
  - type: OpenAPI
    url: openapi/finnhub-crypto-api-openapi.yml
- aid: finnhub:finnhub-forex-api
  name: Finnhub Forex API
  description: The Forex API from Finnhub — 3 operation(s) for forex.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Forex
  properties:
  - type: OpenAPI
    url: openapi/finnhub-forex-api-openapi.yml
- aid: finnhub:finnhub-news-api
  name: Finnhub News API
  description: The News API from Finnhub — 1 operation(s) for news.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/finnhub-news-api-openapi.yml
- aid: finnhub:finnhub-quote-api
  name: Finnhub Quote API
  description: The Quote API from Finnhub — 1 operation(s) for quote.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Quote
  properties:
  - type: OpenAPI
    url: openapi/finnhub-quote-api-openapi.yml
- aid: finnhub:finnhub-search-api
  name: Finnhub Search API
  description: The Search API from Finnhub — 1 operation(s) for search.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/finnhub-search-api-openapi.yml
- aid: finnhub:finnhub-stock-api
  name: Finnhub Stock API
  description: The Stock API from Finnhub — 5 operation(s) for stock.
  humanURL: https://finnhub.io/docs/api
  baseURL: https://finnhub.io/api/v1
  tags:
  - Stock
  properties:
  - type: OpenAPI
    url: openapi/finnhub-stock-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/finnhub-agentic-access.yml
- type: DomainSecurity
  url: security/finnhub-domain-security.yml
- type: Authentication
  url: authentication/finnhub-authentication.yml
- type: OpenAPI
  url: openapi/finnhub-swagger-original.json
- type: Packages
  url: packages/finnhub-packages.yml
- type: SDKs
  url: packages/finnhub-packages.yml
- type: MCPServer
  url: mcp/finnhub-mcp.yml
- type: ToolCrosswalk
  url: mcp/finnhub-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/finnhub-llms.txt
- type: Overlay
  url: overlays/finnhub-swagger-overlay.yaml
- type: Conformance
  url: conformance/finnhub-conformance.yml
- type: ErrorCatalog
  url: errors/finnhub-problem-types.yml
- type: Lifecycle
  url: lifecycle/finnhub-lifecycle.yml
- type: Conventions
  url: conventions/finnhub-conventions.yml
- type: DataModel
  url: data-model/finnhub-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
- type: RateLimits
  url: rate-limits/finnhub-rate-limits.yml
- type: Plans
  url: plans/finnhub-plans-pricing.yml
- type: FinOps
  url: finops/finnhub-finops.yml
- type: Postman
  url: collections/finnhub.postman_collection.json
- type: LinkedIn
  url: https://www.linkedin.com/company/finnhub
- type: Website
  url: https://finnhub.io/
- type: Documentation
  url: https://finnhub.io/docs/api
- type: APIReference
  url: https://finnhub.io/docs/api
- type: GitHubOrganization
  url: https://github.com/Finnhub-Stock-API
- type: Support
  url: mailto:support@finnhub.io
- type: TermsOfService
  url: https://finnhub.io/terms-of-service
- type: Pricing
  url: https://finnhub.io/pricing
- type: Signup
  url: https://finnhub.io/register
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com