---
source_url: "https://docs.agno.com/tools/toolkits/others/financial-datasets"
title: Financial Datasets API - Agno
mirrored_at: 2026-08-13T01:05:34.485Z
host: docs.agno.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/docs.agno.com/tools/toolkits/others/financial-datasets"
---

> **Original source:** https://docs.agno.com/tools/toolkits/others/financial-datasets

**FinancialDatasetsTools** provide a comprehensive API for retrieving and analyzing diverse financial datasets, including stock prices, financial statements, company information, SEC filings, and cryptocurrency data from multiple providers.

## Prerequisites

The toolkit requires a Financial Datasets API key that can be obtained by creating an account at [financialdatasets.ai](https://financialdatasets.ai/).

Set your API key as an environment variable:

## Example

Basic usage of the Financial Datasets toolkit:

See the full [Financial Datasets example](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/financial_datasets_tools.py) in the cookbook.

## Toolkit Params

Parameter

Type

Default

Description

`api_key`

`Optional[str]`

`None`

Optional API key. If not provided, uses FINANCIAL\_DATASETS\_API\_KEY environment variable

`timeout`

`int`

`30`

Per-request HTTP timeout in seconds

## Toolkit Functions

Function

Description

`get_income_statements`

Get income statements for a company with options for annual, quarterly, or trailing twelve months (ttm) periods

`get_balance_sheets`

Get balance sheets for a company with period options

`get_cash_flow_statements`

Get cash flow statements for a company

`get_company_info`

Get company information including business description, sector, and industry

`get_crypto_prices`

Get cryptocurrency prices with configurable time intervals

`get_earnings`

Get earnings reports with EPS estimates, actuals, and revenue data

`get_financial_metrics`

Get key financial metrics and ratios for a company

`get_insider_trades`

Get data on insider buying and selling activity

`get_institutional_ownership`

Get information about institutional investors and their positions

`get_news`

Get market news, optionally filtered by company

`get_stock_prices`

Get historical stock prices with configurable time intervals

`search_tickers`

Search for stock tickers based on a query string

`get_sec_filings`

Get SEC filings with optional filtering by form type (10-K, 10-Q, etc.)

`get_segmented_financials`

Get segmented financial data by product category and geographic region

You can use `include_tools` or `exclude_tools` to modify the list of tools the agent has access to. Learn more about [selecting tools](https://docs.agno.com/tools/selecting-tools).

## Rate Limits and Usage

The Financial Datasets API applies rate limits based on your subscription tier. See [pricing](https://financialdatasets.ai/pricing) for the request allowance and rate limits on each plan.

## Developer Resources

-   [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/financial_datasets.py)