--- type: "firecrawl-provider" description: "Company profiles by ticker, company news over a date range, and symbol search." use_when: "One listed company's Finnhub profile by ticker.\n\nHeadlines and summaries about one North American company over a date range.\n\nResolve a company name, ticker fragment, ISIN, or CUSIP to the symbols Finnhub uses." categories: "Finance" capabilities: 3 credits_per_call: 5 --- # Finnhub on Firecrawl Alexandria Company profiles by ticker, company news over a date range, and symbol search. - Categories: Finance - Category index: [Finance category](https://alexandria.firecrawl.dev/agents/categories/finance) - Provider key: `finnhub-gateway` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/finnhub-gateway) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/openapi.json) ## Capabilities - [Company profile](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/companies/profile): One profile. An unknown symbol returns an empty object, which is still billed. An HTTP error costs nothing. - [Company news](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/news/company): Articles, newest first, capped at limit (default 20). datetime is a UNIX timestamp in seconds. Finnhub covers North American companies only. An empty array is still billed. - [Symbol search](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/symbols/search): Matches in result, best first. count is the number of matches. An empty result is still billed. ## 1. Choose this provider when One listed company's Finnhub profile by ticker. Headlines and summaries about one North American company over a date range. Resolve a company name, ticker fragment, ISIN, or CUSIP to the symbols Finnhub uses. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "finnhub-gateway", "capability": "companies/profile", "options": { "symbol": "" } } ``` ## 3. Add provider options Use only the options needed for the task: - `symbol` (string, required): Ticker, such as AAPL. One symbol per call. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "finnhub-gateway", capability: "companies/profile", options: { symbol: "", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "finnhub-gateway", "capability": "companies/profile", "options": { "symbol": "" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "finnhub-gateway", "capability": "companies/profile", "options": { "symbol": "" } } }' ``` ### CLI ```sh firecrawl scrape 'finnhub-gateway/companies/profile' \ --options '{"symbol":""}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "finnhub-gateway", "capability": "companies/profile", "options": { "symbol": "" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "finnhub-gateway", "capability": "companies/profile", "options": { "symbol": "" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "name": "", "ticker": "", "exchange": "", "country": "", "currency": "", "ipo": "", "marketCapitalization": 0, "shareOutstanding": 0, "finnhubIndustry": "", "weburl": "", "logo": "", "phone": "" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Company profile - Capability: `companies/profile` - Description: One profile. An unknown symbol returns an empty object, which is still billed. An HTTP error costs nothing. - Instructions: Read one listed company's name, exchange, country, currency, IPO date, market capitalization, shares outstanding, website, logo, and Finnhub industry by ticker. 5 credits per successful call, including an unknown symbol that returns an empty object. Use symbols/search first when only the company name is known. - Cost: 5 credits per call - Capability file: [Company profile](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/companies/profile) Accepted options: - `symbol` (string, required): Ticker, such as AAPL. One symbol per call. Example: `` Response schema example: ```json { "name": "", "ticker": "", "exchange": "", "country": "", "currency": "", "ipo": "", "marketCapitalization": 0, "shareOutstanding": 0, "finnhubIndustry": "", "weburl": "", "logo": "", "phone": "" } ``` ### Company news - Capability: `news/company` - Description: Articles, newest first, capped at limit (default 20). datetime is a UNIX timestamp in seconds. Finnhub covers North American companies only. An empty array is still billed. - Instructions: List news headlines, summaries, sources, and article links about one North American company between two dates, newest first, 20 by default and at most 100. 5 credits per successful call, including an empty list. Use companies/profile for the company itself. - Cost: 5 credits per call - Capability file: [Company news](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/news/company) Accepted options: - `symbol` (string, required): Ticker, such as AAPL. One symbol per call. Example: `` - `from` (string, required): Start date, YYYY-MM-DD. Example: `` - `to` (string, required): End date, YYYY-MM-DD. On or after from. Example: `` - `limit` (number): Most articles to return, newest first. Default 20, at most 100. Applied to Finnhub's full answer. Example: `20` Response schema example: ```json [ { "id": 0, "datetime": 0, "headline": "", "summary": "", "source": "", "url": "", "image": "", "category": "", "related": "" } ] ``` ### Symbol search - Capability: `symbols/search` - Description: Matches in result, best first. count is the number of matches. An empty result is still billed. - Instructions: Resolve a company name, ticker fragment, ISIN, or CUSIP to Finnhub symbols with their description and security type. 5 credits per successful call, even when nothing matches. Use companies/profile or news/company with the symbol that comes back. - Cost: 5 credits per call - Capability file: [Symbol search](https://alexandria.firecrawl.dev/agents/providers/finnhub-gateway/symbols/search) Accepted options: - `q` (string, required): Company name, ticker fragment, ISIN, or CUSIP to match, such as apple. Example: `` Response schema example: ```json { "result": [ { "symbol": "", "displaySymbol": "", "description": "", "type": "" } ] } ```