Finnhub | Apiosk Gateway

Method	Path	Description	Cost
GET	/calendar/earnings	Earnings calendar: historical and upcoming earnings releases. EPS and revenue figures are non-GAAP.	$0.13 default	View details
GET	/calendar/ipo	Recent and upcoming IPOs.	$0.02 default	View details
GET	/company-news	Latest company news for a symbol over a date range (North American companies only).	$0.13 default	View details
GET	/country	List all countries and metadata (codes, currency, region).	$0.01 default	View details
GET	/crypto/exchange	List supported crypto exchanges.	$0.01 default	View details
GET	/crypto/symbol	List supported crypto symbols by exchange.	$0.01 default	View details
GET	/fda-advisory-committee-calendar	FDA advisory committee meeting calendar.	$0.02 default	View details
GET	/forex/exchange	List supported forex exchanges.	$0.01 default	View details
GET	/forex/symbol	List supported forex symbols for an exchange.	$0.01 default	View details
GET	/news	Latest general market news by category.	$0.12 default	View details
GET	/quote	Real-time quote snapshot for a US stock: open, high, low, current price, previous close and change. Use as polled snapshots, not a streaming substitute.	$0.12 default	View details
GET	/search	Symbol lookup. Search by ticker, company name, ISIN or CUSIP.	$0.11 default	View details
GET	/stock/earnings	Historical quarterly earnings surprises (actual vs estimate) back to 2000.	$0.03 default	View details
GET	/stock/filings	List a company's SEC filings. Up to 250 documents per call.	$0.03 default	View details
GET	/stock/financials-reported	Financials as reported (balance sheet, income statement, cash flow) from SEC filings.	$0.05 default	View details
GET	/stock/insider-sentiment	Insider sentiment data for US companies (MSPR / change), computed from insider activity.	$0.04 default	View details
GET	/stock/insider-transactions	Insider buy/sell transactions from Form 3/4/5, SEDI and company filings (US, UK, CA, AU, IN and major EU markets). Max 100 transactions per call.	$0.15 default	View details
GET	/stock/lobbying	Reported lobbying activities in the US Senate and House for a company.	$0.03 default	View details
GET	/stock/market-holiday	List of market holidays for global exchanges.	$0.01 default	View details
GET	/stock/market-status	Current market status for global exchanges (open/closed).	$0.01 default	View details
GET	/stock/metric	Basic financials: company key metrics and ratios (margins, P/E, 52-week high/low, and more).	$0.15 default	View details
GET	/stock/peers	Company peers operating in the same country and sector/industry.	$0.02 default	View details
GET	/stock/profile2	Company profile: general company info (free Company Profile). Query by symbol, ISIN or CUSIP (at least one required).	$0.12 default	View details
GET	/stock/recommendation	Latest analyst recommendation trends: buy/hold/sell counts per period.	$0.13 default	View details
GET	/stock/symbol	List supported stock symbols for a given exchange.	$0.01 default	View details
GET	/stock/usa-spending	US government spending/contracts awarded to a public company (USASpending).	$0.03 default	View details
GET	/stock/uspto-patent	USPTO patents filed by a company over a date range. Up to 250 records per call.	$0.03 default	View details
GET	/stock/visa-application	H1-B and Permanent visa applications for a company from the US DOL.	$0.03 default	View details

GET/calendar/earnings

$0.13 default

Description

Earnings calendar: historical and upcoming earnings releases. EPS and revenue figures are non-GAAP.

Pricing

$0.13 default

Parameters

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  },
  "international": {
    "description": "Include international markets (default false)",
    "required": false,
    "type": "boolean"
  },
  "symbol": {
    "description": "Filter by symbol",
    "required": false,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "earningsCalendar": {
      "items": {
        "properties": {
          "date": {
            "type": "string"
          },
          "epsActual": {
            "type": "number"
          },
          "epsEstimate": {
            "type": "number"
          },
          "hour": {
            "description": "bmo, amc or dmh",
            "type": "string"
          },
          "quarter": {
            "type": "integer"
          },
          "revenueActual": {
            "type": "number"
          },
          "revenueEstimate": {
            "type": "number"
          },
          "symbol": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Example response

{
  "earningsCalendar": [
    {
      "date": "2026-07-31",
      "epsActual": null,
      "epsEstimate": 1.42,
      "hour": "amc",
      "quarter": 3,
      "revenueActual": null,
      "revenueEstimate": 89000000000,
      "symbol": "AAPL",
      "year": 2026
    }
  ]
}

GET/calendar/ipo

$0.02 default

Description

Recent and upcoming IPOs.

Pricing

$0.02 default

GET/company-news

$0.13 default

Description

Latest company news for a symbol over a date range (North American companies only).

Pricing

$0.13 default

Parameters

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": true,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": true,
    "type": "string"
  }
}

Response schema

{
  "items": {
    "properties": {
      "category": {
        "type": "string"
      },
      "datetime": {
        "description": "UNIX timestamp",
        "type": "integer"
      },
      "headline": {
        "type": "string"
      },
      "id": {
        "type": "integer"
      },
      "image": {
        "type": "string"
      },
      "related": {
        "type": "string"
      },
      "source": {
        "type": "string"
      },
      "summary": {
        "type": "string"
      },
      "url": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

Example response

[
  {
    "category": "company news",
    "datetime": 1718841600,
    "headline": "Apple announces new product line",
    "id": 131982009,
    "image": "https://example.com/img.jpg",
    "related": "AAPL",
    "source": "Reuters",
    "summary": "Summary of the article.",
    "url": "https://example.com/article"
  }
]

GET/country

$0.01 default

Description

List all countries and metadata (codes, currency, region).

Pricing

$0.01 default

GET/crypto/exchange

$0.01 default

Description

List supported crypto exchanges.

Pricing

$0.01 default

GET/crypto/symbol

$0.01 default

Description

List supported crypto symbols by exchange.

Pricing

$0.01 default

GET/fda-advisory-committee-calendar

$0.02 default

Description

FDA advisory committee meeting calendar.

Pricing

$0.02 default

GET/forex/exchange

$0.01 default

Description

List supported forex exchanges.

Pricing

$0.01 default

GET/forex/symbol

$0.01 default

Description

List supported forex symbols for an exchange.

Pricing

$0.01 default

GET/news

$0.12 default

Description

Latest general market news by category.

Pricing

$0.12 default

Parameters

{
  "category": {
    "description": "One of general, forex, crypto, merger",
    "required": true,
    "type": "string"
  },
  "minId": {
    "description": "Only return news after this id (default 0)",
    "required": false,
    "type": "integer"
  }
}

Response schema

{
  "items": {
    "properties": {
      "category": {
        "type": "string"
      },
      "datetime": {
        "description": "UNIX timestamp",
        "type": "integer"
      },
      "headline": {
        "type": "string"
      },
      "id": {
        "type": "integer"
      },
      "image": {
        "type": "string"
      },
      "related": {
        "type": "string"
      },
      "source": {
        "type": "string"
      },
      "summary": {
        "type": "string"
      },
      "url": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

Example response

[
  {
    "category": "top news",
    "datetime": 1718841600,
    "headline": "Markets rally on rate-cut hopes",
    "id": 7654321,
    "image": "https://example.com/news.jpg",
    "related": "",
    "source": "Reuters",
    "summary": "Summary of the article.",
    "url": "https://example.com/news"
  }
]

GET/quote

$0.12 default

Description

Real-time quote snapshot for a US stock: open, high, low, current price, previous close and change. Use as polled snapshots, not a streaming substitute.

Pricing

$0.12 default

Parameters

{
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "c": {
      "description": "Current price",
      "type": "number"
    },
    "d": {
      "description": "Change",
      "type": "number"
    },
    "dp": {
      "description": "Percent change",
      "type": "number"
    },
    "h": {
      "description": "High",
      "type": "number"
    },
    "l": {
      "description": "Low",
      "type": "number"
    },
    "o": {
      "description": "Open",
      "type": "number"
    },
    "pc": {
      "description": "Previous close",
      "type": "number"
    }
  },
  "type": "object"
}

Example response

{
  "c": 214.29,
  "d": 1.1,
  "dp": 0.5156,
  "h": 215.18,
  "l": 211.3,
  "o": 211.8,
  "pc": 213.19
}

GET/search

$0.11 default

Description

Symbol lookup. Search by ticker, company name, ISIN or CUSIP.

Pricing

$0.11 default

Parameters

{
  "exchange": {
    "description": "Limit results to a single exchange",
    "required": false,
    "type": "string"
  },
  "q": {
    "description": "Query: ticker, company name, ISIN or CUSIP",
    "required": true,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "count": {
      "type": "integer"
    },
    "result": {
      "items": {
        "properties": {
          "description": {
            "type": "string"
          },
          "displaySymbol": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Example response

{
  "count": 1,
  "result": [
    {
      "description": "APPLE INC",
      "displaySymbol": "AAPL",
      "symbol": "AAPL",
      "type": "Common Stock"
    }
  ]
}

GET/stock/earnings

$0.03 default

Description

Historical quarterly earnings surprises (actual vs estimate) back to 2000.

Pricing

$0.03 default

GET/stock/filings

$0.03 default

Description

List a company's SEC filings. Up to 250 documents per call.

Pricing

$0.03 default

GET/stock/financials-reported

$0.05 default

Description

Financials as reported (balance sheet, income statement, cash flow) from SEC filings.

Pricing

$0.05 default

GET/stock/insider-sentiment

$0.04 default

Description

Insider sentiment data for US companies (MSPR / change), computed from insider activity.

Pricing

$0.04 default

GET/stock/insider-transactions

$0.15 default

Description

Insider buy/sell transactions from Form 3/4/5, SEDI and company filings (US, UK, CA, AU, IN and major EU markets). Max 100 transactions per call.

Pricing

$0.15 default

Parameters

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol. Leave blank for the latest across all companies.",
    "required": true,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "data": {
      "items": {
        "properties": {
          "change": {
            "description": "Positive = buy, negative = sell",
            "type": "number"
          },
          "filingDate": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "share": {
            "description": "Shares held after transaction",
            "type": "number"
          },
          "transactionCode": {
            "type": "string"
          },
          "transactionDate": {
            "type": "string"
          },
          "transactionPrice": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "data": [
    {
      "change": -50000,
      "filingDate": "2026-05-02",
      "name": "Cook Timothy D",
      "share": 3280000,
      "transactionCode": "S",
      "transactionDate": "2026-04-30",
      "transactionPrice": 210.5
    }
  ],
  "symbol": "AAPL"
}

GET/stock/lobbying

$0.03 default

Description

Reported lobbying activities in the US Senate and House for a company.

Pricing

$0.03 default

GET/stock/market-holiday

$0.01 default

Description

List of market holidays for global exchanges.

Pricing

$0.01 default

GET/stock/market-status

$0.01 default

Description

Current market status for global exchanges (open/closed).

Pricing

$0.01 default

GET/stock/metric

$0.15 default

Description

Basic financials: company key metrics and ratios (margins, P/E, 52-week high/low, and more).

Pricing

$0.15 default

Parameters

{
  "metric": {
    "description": "Metric group. Use the value all.",
    "required": true,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "metric": {
      "description": "Map of key ratios and metrics",
      "type": "object"
    },
    "metricType": {
      "type": "string"
    },
    "series": {
      "description": "Time-series ratios",
      "type": "object"
    },
    "symbol": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "metric": {
    "52WeekHigh": 237.23,
    "52WeekLow": 164.08,
    "netProfitMarginAnnual": 24.3,
    "peNormalizedAnnual": 31.2
  },
  "metricType": "all",
  "symbol": "AAPL"
}

GET/stock/peers

$0.02 default

Description

Company peers operating in the same country and sector/industry.

Pricing

$0.02 default

GET/stock/profile2

$0.12 default

Description

Company profile: general company info (free Company Profile). Query by symbol, ISIN or CUSIP (at least one required).

Pricing

$0.12 default

Parameters

{
  "cusip": {
    "description": "CUSIP",
    "required": false,
    "type": "string"
  },
  "isin": {
    "description": "ISIN",
    "required": false,
    "type": "string"
  },
  "symbol": {
    "description": "Ticker; one of symbol/isin/cusip required",
    "required": false,
    "type": "string"
  }
}

Response schema

{
  "properties": {
    "country": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "exchange": {
      "type": "string"
    },
    "finnhubIndustry": {
      "type": "string"
    },
    "ipo": {
      "type": "string"
    },
    "logo": {
      "type": "string"
    },
    "marketCapitalization": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "shareOutstanding": {
      "type": "number"
    },
    "ticker": {
      "type": "string"
    },
    "weburl": {
      "type": "string"
    }
  },
  "type": "object"
}

Example response

{
  "country": "US",
  "currency": "USD",
  "exchange": "NASDAQ NMS - GLOBAL MARKET",
  "finnhubIndustry": "Technology",
  "ipo": "1980-12-12",
  "logo": "https://example.com/aapl.png",
  "marketCapitalization": 3200000,
  "name": "Apple Inc",
  "shareOutstanding": 15000,
  "ticker": "AAPL",
  "weburl": "https://www.apple.com/"
}

GET/stock/recommendation

$0.13 default

Description

Latest analyst recommendation trends: buy/hold/sell counts per period.

Pricing

$0.13 default

Parameters

{
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

Response schema

{
  "items": {
    "properties": {
      "buy": {
        "type": "integer"
      },
      "hold": {
        "type": "integer"
      },
      "period": {
        "type": "string"
      },
      "sell": {
        "type": "integer"
      },
      "strongBuy": {
        "type": "integer"
      },
      "strongSell": {
        "type": "integer"
      },
      "symbol": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

Example response

[
  {
    "buy": 12,
    "hold": 8,
    "period": "2026-06-01",
    "sell": 1,
    "strongBuy": 18,
    "strongSell": 0,
    "symbol": "AAPL"
  }
]

GET/stock/symbol

$0.01 default

Description

List supported stock symbols for a given exchange.

Pricing

$0.01 default

GET/stock/usa-spending

$0.03 default

Description

US government spending/contracts awarded to a public company (USASpending).

Pricing

$0.03 default

GET/stock/uspto-patent

$0.03 default

Description

USPTO patents filed by a company over a date range. Up to 250 records per call.

Pricing

$0.03 default

GET/stock/visa-application

$0.03 default

Description

H1-B and Permanent visa applications for a company from the US DOL.

Pricing

$0.03 default