---
name: orthogonal-finnhub
description: "Call Finnhub through Orthogonal's pay-per-use Run API: Finnhub financial data API: real-time US stock quotes, symbol search, company profiles, basic financials, earnings surprises and calendars, analyst recommendation trends, insider transactions and sentiment, SEC filings, company and market news, forex and crypto symbol lists, plus alternative data such as USPTO patents, H-1B visa applications, lobbying and government spending."
---

# Finnhub — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Finnhub financial data API: real-time US stock quotes, symbol search, company profiles, basic financials, earnings surprises and calendars, analyst recommendation trends, insider transactions and sentiment, SEC filings, company and market news, forex and crypto symbol lists, plus alternative data such as USPTO patents, H-1B visa applications, lobbying and government spending.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Symbol search

Search for best-matching symbols based on your query. You can input anything from symbol, security's name to ISIN and Cusip.

`GET /search`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/b5b2591c-b2d1-43f3-8f3e-3f524e166599

**Docs:** https://finnhub.io/docs/api/symbol-search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q` | string | Yes | Query text can be symbol, name, isin, or cusip. |
| `exchange` | string | No | Exchange limit. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/search","method":"GET","query":{"q":"<string>","exchange":"<string>"}}'
```

### Exchange stock symbols

List supported stocks. We use the following symbology to identify stocks on Finnhub <code>Exchange_Ticker.Exchange_Code</code>. A list of supported exchange codes can be found <a href="https://docs.google.com/spreadsheets/d/1I3pBxjfXB056-g_JYf_6o3Rns3BV2kMGG1nCatb91ls/edit?usp=sharing" target="_blank">here</a>.

`GET /stock/symbol`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/8f7a033d-9123-4af9-b1b5-ccab372ba65f

**Docs:** https://finnhub.io/docs/api/stock-symbols

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | Yes | Exchange you want to get the list of symbols from. List of exchange codes can be found <a href="https://docs.google.com/spreadsheets/d/1I3pBxjfXB056-g_JYf_6o3Rns3BV2kMGG1nCatb91ls/edit?usp=sharing" target="_blank">here</a>. |
| `mic` | string | No | Filter by MIC code. |
| `securityType` | string | No | Filter by security type used by OpenFigi standard. |
| `currency` | string | No | Filter by currency. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/symbol","method":"GET","query":{"exchange":"<string>","mic":"<string>","securityType":"<string>","currency":"<string>"}}'
```

### Market status

Get current market status for global exchanges (whether exchanges are open or close).

`GET /stock/market-status`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/8914c456-40fa-452d-8474-57fa85a3f4cc

**Docs:** https://finnhub.io/docs/api/market-status

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | Yes | Exchange code. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/market-status","method":"GET","query":{"exchange":"<string>"}}'
```

### Market holidays

Get a list of holidays for global exchanges.

`GET /stock/market-holiday`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/bd47bac1-d46c-45ab-ad6d-1ebdb4e4637a

**Docs:** https://finnhub.io/docs/api/market-holiday

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | Yes | Exchange code. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/market-holiday","method":"GET","query":{"exchange":"<string>"}}'
```

### Company profile (basic)

Get general information of a company. You can query by symbol, ISIN or CUSIP. This is the free version of <a href="#company-profile">Company Profile</a>.

`GET /stock/profile2`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/ca232062-414a-4a09-9ae5-45de9ae90ab4

**Docs:** https://finnhub.io/docs/api/company-profile2

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | No | Symbol of the company: AAPL e.g. |
| `isin` | string | No | ISIN |
| `cusip` | string | No | CUSIP |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/profile2","method":"GET","query":{"symbol":"<string>","isin":"<string>","cusip":"<string>"}}'
```

### Market news

Get latest market news.

`GET /news`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/f3b72b51-4649-4188-81a1-d88012029eeb

**Docs:** https://finnhub.io/docs/api/market-news

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | This parameter can be 1 of the following values <code>general, forex, crypto, merger</code>. |
| `minId` | integer | No | Use this field to get only news after this ID. Default to 0 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/news","method":"GET","query":{"category":"<string>","minId":"<integer>"}}'
```

### Company news

List latest company news by symbol. This endpoint is only available for North American companies.

`GET /company-news`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/fc6da0cd-b750-4492-9e03-2f9eca325221

**Docs:** https://finnhub.io/docs/api/company-news

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Company symbol. |
| `from` | string | Yes | From date <code>YYYY-MM-DD</code>. |
| `to` | string | Yes | To date <code>YYYY-MM-DD</code>. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/company-news","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Company peers

Get company peers. Return a list of peers operating in the same country and sector/industry.

`GET /stock/peers`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/89b2f329-95dd-48e2-8969-0e8fcc58d696

**Docs:** https://finnhub.io/docs/api/company-peers

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. |
| `grouping` | string | No | Specify the grouping criteria for choosing peers.Supporter values: <code>sector</code>, <code>industry</code>, <code>subIndustry</code>. Default to <code>subIndustry</code>. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/peers","method":"GET","query":{"symbol":"<string>","grouping":"<string>"}}'
```

### Basic financials

Get company basic financials such as margin, P/E ratio, 52-week high/low etc.

`GET /stock/metric`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/fc523c57-e6a6-4b1a-9944-26642504d04e

**Docs:** https://finnhub.io/docs/api/company-basic-financials

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. |
| `metric` | string | Yes | Metric type. Can be 1 of the following values <code>all</code> |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/metric","method":"GET","query":{"symbol":"<string>","metric":"<string>"}}'
```

### Insider transactions

Company insider transactions data sourced from <code>Form 3,4,5</code>, SEDI and relevant companies' filings. This endpoint covers US, UK, Canada, Australia, India, and all major EU markets. Limit to 100 transactions per API call.

`GET /stock/insider-transactions`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/548d09ba-160c-482a-8353-316deda3a9d5

**Docs:** https://finnhub.io/docs/api/insider-transactions

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. Leave this param blank to get the latest transactions. |
| `from` | string | No | From date: 2020-03-15. |
| `to` | string | No | To date: 2020-03-16. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/insider-transactions","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Insider sentiment

Get insider sentiment data for US companies calculated using method discussed <a href="https://medium.com/@stock-api/finnhub-insiders-sentiment-analysis-cc43f9f64b3a" target="_blank">here</a>. The MSPR ranges from -100 for the most negative to 100 for the most positive which can signal price changes in the coming 30-90 days.

`GET /stock/insider-sentiment`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/c65a2a5d-a6df-417d-846d-e995e6e403b2

**Docs:** https://finnhub.io/docs/api/insider-sentiment

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. |
| `from` | string | Yes | From date: 2020-03-15. |
| `to` | string | Yes | To date: 2020-03-16. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/insider-sentiment","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Financials as reported

Get financials as reported. This data is available for bulk download on <a href="https://www.kaggle.com/finnhub/reported-financials" target="_blank">Kaggle SEC Financials database</a>.

`GET /stock/financials-reported`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/153ff1be-ac46-458b-8bd8-7f336e770ac8

**Docs:** https://finnhub.io/docs/api/financials-reported

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | No | Symbol. |
| `cik` | string | No | CIK. |
| `accessNumber` | string | No | Access number of a specific report you want to retrieve financials from. |
| `freq` | string | No | Frequency. Can be either <code>annual</code> or <code>quarterly</code>. Default to <code>annual</code>. |
| `from` | string | No | From date <code>YYYY-MM-DD</code>. Filter for endDate. |
| `to` | string | No | To date <code>YYYY-MM-DD</code>. Filter for endDate. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/financials-reported","method":"GET","query":{"symbol":"<string>","cik":"<string>","accessNumber":"<string>","freq":"<string>","from":"<string>","to":"<string>"}}'
```

### SEC filings

List company's filing. Limit to 250 documents at a time. This data is available for bulk download on <a href="https://www.kaggle.com/finnhub/sec-filings" target="_blank">Kaggle SEC Filings database</a>.

`GET /stock/filings`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/6890fc39-844b-4acc-9d36-f2bfa944cf54

**Docs:** https://finnhub.io/docs/api/filings

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | No | Symbol. Leave <code>symbol</code>,<code>cik</code> and <code>accessNumber</code> empty to list latest filings. |
| `cik` | string | No | CIK. |
| `accessNumber` | string | No | Access number of a specific report you want to retrieve data from. |
| `form` | string | No | Filter by form. You can use this value <code>NT 10-K</code> to find non-timely filings for a company. |
| `from` | string | No | From date: 2023-03-15. |
| `to` | string | No | To date: 2023-03-16. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/filings","method":"GET","query":{"symbol":"<string>","cik":"<string>","accessNumber":"<string>","form":"<string>","from":"<string>","to":"<string>"}}'
```

### IPO calendar

Get recent and upcoming IPO.

`GET /calendar/ipo`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/bf6f48b5-b557-4d84-b6a8-7bac5c337479

**Docs:** https://finnhub.io/docs/api/ipo-calendar

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | string | Yes | From date: 2020-03-15. |
| `to` | string | Yes | To date: 2020-03-16. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/calendar/ipo","method":"GET","query":{"from":"<string>","to":"<string>"}}'
```

### Analyst recommendation trends

Get latest analyst recommendation trends for a company.

`GET /stock/recommendation`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/816acc5f-d4a3-46f6-b698-3a5884786f13

**Docs:** https://finnhub.io/docs/api/recommendation-trends

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/recommendation","method":"GET","query":{"symbol":"<string>"}}'
```

### Earnings surprises

Get company historical quarterly earnings surprise going back to 2000.

`GET /stock/earnings`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/efcab0cc-fbe3-4159-990f-524b6138593a

**Docs:** https://finnhub.io/docs/api/company-earnings

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol of the company: AAPL. |
| `limit` | integer | No | Limit number of period returned. Leave blank to get the full history. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/earnings","method":"GET","query":{"symbol":"<string>","limit":"<integer>"}}'
```

### Earnings calendar

Get historical and coming earnings release. EPS and Revenue in this endpoint are non-GAAP, which means they are adjusted to exclude some one-time or unusual items. This is the same data investors usually react to and talked about on the media. Estimates are sourced from both sell-side and buy-side analysts.

`GET /calendar/earnings`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/5f39dac9-3a67-4284-b249-4c4b874bc604

**Docs:** https://finnhub.io/docs/api/earnings-calendar

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | string | No | From date: 2020-03-15. |
| `to` | string | No | To date: 2020-03-16. |
| `symbol` | string | No | Filter by symbol: AAPL. |
| `international` | boolean | No | Set to <code>true</code> to include international markets. Default value is <code>false</code> |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/calendar/earnings","method":"GET","query":{"from":"<string>","to":"<string>","symbol":"<string>","international":"<boolean>"}}'
```

### Stock quote

<p>Get real-time quote data for US stocks. Constant polling is not recommended. Use websocket if you need real-time updates.</p><p>Real-time stock prices for international markets are supported for Enterprise clients via our partner's feed. <a href="mailto:support@finnhub.io">Contact Us</a> to learn more.</p>

`GET /quote`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/ec1f331b-7f7d-4cdb-b944-b5ab8713d1c7

**Docs:** https://finnhub.io/docs/api/quote

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/quote","method":"GET","query":{"symbol":"<string>"}}'
```

### Forex exchanges

List supported forex exchanges

`GET /forex/exchange`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/daaa6af0-8575-4274-af1f-706978e7bf08

**Docs:** https://finnhub.io/docs/api/forex-exchanges

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/forex/exchange","method":"GET"}'
```

### Forex symbols

List supported forex symbols.

`GET /forex/symbol`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/4bf13d09-78b5-4919-bcbe-bb5c0b55cf1e

**Docs:** https://finnhub.io/docs/api/forex-symbols

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | Yes | Exchange you want to get the list of symbols from. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/forex/symbol","method":"GET","query":{"exchange":"<string>"}}'
```

### Crypto exchanges

List supported crypto exchanges

`GET /crypto/exchange`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/846a1e1a-594e-4251-8218-d281f857b6a2

**Docs:** https://finnhub.io/docs/api/crypto-exchanges

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/crypto/exchange","method":"GET"}'
```

### Crypto symbols

List supported crypto symbols by exchange

`GET /crypto/symbol`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/2286b671-10f6-4f5c-8006-59c64748ef4a

**Docs:** https://finnhub.io/docs/api/crypto-symbols

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `exchange` | string | Yes | Exchange you want to get the list of symbols from. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/crypto/symbol","method":"GET","query":{"exchange":"<string>"}}'
```

### FDA committee calendar

FDA's advisory committees are established to provide functions which support the agency's mission of protecting and promoting the public health, while meeting the requirements set forth in the Federal Advisory Committee Act. Committees are either mandated by statute or established at the discretion of the Department of Health and Human Services. Each committee is subject to renewal at two-year intervals unless the committee charter states otherwise.

`GET /fda-advisory-committee-calendar`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/0a422119-70cd-4e28-98a5-bd586eba9937

**Docs:** https://finnhub.io/docs/api/fda-committee-meeting-calendar

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/fda-advisory-committee-calendar","method":"GET"}'
```

### USPTO patents

List USPTO patents for companies. Limit to 250 records per API call.

`GET /stock/uspto-patent`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/d9ff7942-15e4-47d2-a02b-2d07de56646d

**Docs:** https://finnhub.io/docs/api/stock-uspto-patent

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol. |
| `from` | string | Yes | From date <code>YYYY-MM-DD</code>. |
| `to` | string | Yes | To date <code>YYYY-MM-DD</code>. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/uspto-patent","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### H-1B visa applications

Get a list of H1-B and Permanent visa applications for companies from the DOL. The data is updated quarterly.

`GET /stock/visa-application`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/d005b036-556e-400c-8d9a-785a4d244d6b

**Docs:** https://finnhub.io/docs/api/stock-visa-application

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol. |
| `from` | string | Yes | From date <code>YYYY-MM-DD</code>. Filter on the <code>beginDate</code> column. |
| `to` | string | Yes | To date <code>YYYY-MM-DD</code>. Filter on the <code>beginDate</code> column. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/visa-application","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Senate lobbying

Get a list of reported lobbying activities in the Senate and the House.

`GET /stock/lobbying`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/fa6569ce-df43-4ce4-9d1b-0ca32e880c89

**Docs:** https://finnhub.io/docs/api/stock-lobbying

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol. |
| `from` | string | Yes | From date <code>YYYY-MM-DD</code>. |
| `to` | string | Yes | To date <code>YYYY-MM-DD</code>. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/lobbying","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Government spending contracts

<p>Get a list of government's spending activities from USASpending dataset for public companies. This dataset can help you identify companies that win big government contracts which is extremely important for industries such as Defense, Aerospace, and Education. Only recent data is available via the API.</p><p>For historical data, you can download it here: <a href="/api/v1/stock/usa-spending?fileId=before_2021&token=" target="_blank">Pre-2021</a>, <a href="/api/v1/stock/usa-spending?fileId=2021&token=" target="_blank">2021</a>, <a href="/api/v1/stock/usa-spending?fileId=2022&token=" target="_blank">2022</a>, <a href="/api/v1/stock/usa-spending?fileId=2023&token=" target="_blank">2023</a>, <a href="/api/v1/stock/usa-spending?fileId=2024&token=" target="_blank">2024</a></p>

`GET /stock/usa-spending`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/280a9a5a-9caa-4e8d-8f8b-e1bf05c1f894

**Docs:** https://finnhub.io/docs/api/stock-usa-spending

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Symbol. |
| `from` | string | Yes | From date <code>YYYY-MM-DD</code>. Filter for <code>actionDate</code> |
| `to` | string | Yes | To date <code>YYYY-MM-DD</code>. Filter for <code>actionDate</code> |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/stock/usa-spending","method":"GET","query":{"symbol":"<string>","from":"<string>","to":"<string>"}}'
```

### Country metadata

List all countries and metadata.

`GET /country`

**Estimated cost:** $0.00109

**Page:** https://www.orthogonal.com/api/finnhub/8275dbbf-2221-4f7f-9378-86aaa323005a

**Docs:** https://finnhub.io/docs/api/country

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"finnhub","path":"/country","method":"GET"}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/finnhub
