Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Finnhub API

Give your agents access to Finnhub API. Bring your own Finnhub key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Finnhub

Instant

Finnhub is a market data API delivering real-time quotes, company fundamentals, and financial news. Use it to power trading apps, research, alerts, and analytics with timely market intelligence.

11 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Finnhub without a separate account or API key for each one. New accounts start with $2 of free credit.

No Finnhub account or key

Your agent calls Finnhub through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.02 per Finnhub API request, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Finnhub with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Finnhub API to your AI assistant

Use Finnhub from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use Finnhub through Composio Instant to get the latest price snapshot for AAPL. Return the snapshot in your reply.

What success looks like

FINNHUB_GET_QUOTE

Your assistant runs Finnhub and replies with the latest price snapshot for AAPL.

Runs on Composio Instant

SDK

Use the Finnhub API in your code

Call Finnhub from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
FINNHUB_GET_QUOTE
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["finnhub"],
    instant={
        "toolkits": {"enable": ["finnhub"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "FINNHUB_GET_QUOTE",
    arguments={
        "symbol": "AAPL",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["finnhub"],
  instant: {
    toolkits: { enable: ["finnhub"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "FINNHUB_GET_QUOTE",
  {
    "symbol": "AAPL"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": "<latest price snapshot>",
  "error": "<error or null>",
  "successful": "<boolean>",
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Finnhub API tools

11 Finnhub tools run on Instant, priced per call with no Finnhub key.

Action	Tool slug	What it does	Availability
Get Quote	FINNHUB_GET_QUOTE	Get the latest price snapshot for one Finnhub symbol.	Instant$0.02 per Finnhub API request100% off
Get Company Profile	FINNHUB_GET_COMPANY_PROFILE	Look up a company profile by ticker, ISIN, or CUSIP.	Instant$0.02 per Finnhub API request100% off
Get Financial Metrics	FINNHUB_GET_COMPANY_FINANCIAL_METRICS	Retrieve a company's key ratios and annual or quarterly metrics.	Instant$0.02 per Finnhub API request100% off
Search News	FINNHUB_SEARCH_NEWS	Find broad market or company news for a date range.	Instant$0.02 per Finnhub news API request100% off
Search Symbols	FINNHUB_SEARCH_SYMBOLS	Find tradable symbols by ticker, company name, ISIN, or CUSIP.	Instant$0.02 per Finnhub API request100% off
Get Reported Financials	FINNHUB_GET_REPORTED_FINANCIALS	Retrieve a company's as-reported balance sheets, cash flows, and income statements.	Instant$0.02 per Finnhub API request100% off
List Calendar Events	FINNHUB_LIST_CALENDAR_EVENTS	List earnings releases or IPO events within a date range.	Instant$0.02 per Finnhub API request100% off
Get Market Status	FINNHUB_GET_MARKET_STATUS	Check whether an exchange is open now and identify its current session, timezone, or holiday.	Instant$0.02 per Finnhub API request100% off
Get Quotes	FINNHUB_GET_QUOTES	Get price snapshots for 1-10 Finnhub symbols in one tool call.	Instant$0.02 per Finnhub API request; 1-10 requests ($0.02-$0.2) per tool call100% off
List Earnings Results	FINNHUB_LIST_EARNINGS_RESULTS	List a company's recent actual versus estimated earnings and surprise values.	Instant$0.02 per Finnhub API request100% off
List SEC Filings	FINNHUB_LIST_SEC_FILINGS	List SEC filing metadata; a ticker, CIK, or accession number is required, optionally filtered by form and an ordered date range.	Instant$0.02 per Finnhub API request100% off

Instant prices are Finnhub's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Finnhub API use cases and example prompts

Copy a prompt into your agent. Each one uses Finnhub with apps you connect through Composio.

Track market watchlist moves
Use Finnhub to get the latest quotes and key financial metrics for the tickers in my Market Watch sheet in Google Sheets. Update each row with the latest data, then post a brief summary of the biggest moves in Slack's #market-watch channel.
Apps used: Finnhub, Google Sheets, Slack
Write a company financial brief
Use Finnhub to look up Acme's company profile and retrieve its reported financial statements. Write a company brief with the profile and key points from the balance sheets, cash flows, and income statements in my Market Research folder in Google Docs.
Apps used: Finnhub, Google Docs
Plan the earnings calendar
Use Finnhub to find earnings events for the companies in my Earnings Watchlist for the next month. Add each event to my Earnings calendar in Google Calendar, then post a summary in Slack's #finance channel.
Apps used: Finnhub, Google Calendar, Slack
Prepare an Acme account update
Use the ticker in Acme's company record in HubSpot to look up its Finnhub company profile, financial metrics, and recent company news. Add a summary to the Acme company record in HubSpot, then draft a Gmail message to my account team with the key updates.
Apps used: Finnhub, HubSpot, Gmail

TROUBLESHOOTING

Finnhub API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Use FINNHUB_SEARCH_NEWS with news_type set to company, the exact symbol, and from_date and to_date in YYYY-MM-DD format.

Set include_statement_details to true in FINNHUB_GET_REPORTED_FINANCIALS to include the full balance-sheet, cash-flow, and income-statement arrays.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Finnhub account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Alpha vantage

Api Key

Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.

Twelve data

Api Key

Twelve Data is a financial data API providing real-time and historical market data for stocks, forex, crypto, ETFs, and indices. It helps you access accurate, up-to-date financial information for analysis and automation.

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Start with Finnhub.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Finnhub tool your agent needs.Free to start.

Start building

Finnhub API

What is Composio Instant?

No Finnhub account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Finnhub API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Finnhub API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Finnhub API tools

Finnhub API use cases and example prompts

Track market watchlist moves

Write a company financial brief

Plan the earnings calendar

Prepare an Acme account update

Finnhub API troubleshooting

Company news is missing for a ticker

Reported financials omit statement line items

An action asks you to connect Finnhub

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Alpha vantage

Twelve data

Firecrawl

Tavily

Start with Finnhub.It takes 30 seconds.