fdnpy 0.3.0
A Python SDK for FinancialData.Net API
Requires Python: >=3.6
Keywords: python, api, finance, stock-market, algotrading, quant, quantitative-finance, stock-data, stock-prices, financial-data, algorithmic-trading, quantitative-trading, financial-markets, stock-trading, stock-api, financial-modeling, investing-api, stock-market-api, financial-data-api

# **fdnpy**

Complete Python SDK for [FinancialData.Net](https://financialdata.net/) API

## **Installation**

```
pip install fdnpy
```
## **Usage Example**

```python
from fdnpy import FinancialDataClient

# Replace 'YOUR_API_KEY' with your actual key  
client = FinancialDataClient(api_key='YOUR_API_KEY')

# Get stock prices for Microsoft  
prices = client.get_stock_prices(identifier='MSFT')  
print(prices[0], end='\n\n')

# Get Microsoft's balance sheet  
balance_sheet = client.get_balance_sheet_statements(identifier='MSFT', period='year')  
print(balance_sheet[0])  
```

## Overview

`FinancialDataClient` is the main entry point for interacting with FinancialData.Net API v1.  
The client uses `requests` under the hood and supports automatic pagination, retries with exponential backoff, and structured access to financial data endpoints.


## Core Methods

### make_request(endpoint, params)

Low-level HTTP request handler with retries.

### get_data(endpoint, params, limit)

Handles pagination and aggregates all available records.


## API Endpoints

### Symbol Lists
- get_stock_symbols()
- get_international_stock_symbols()
- get_etf_symbols()
- get_commodity_symbols()
- get_otc_symbols()

### Market Data
- get_stock_quotes(identifiers)
- get_stock_prices(identifier)
- get_international_stock_prices(identifier)
- get_minute_prices(identifier, date)
- get_latest_prices(identifier)
- get_commodity_prices(identifier)
- get_otc_prices(identifier)
- get_otc_volume(identifier)

### Market Indexes
- get_index_symbols()
- get_index_quotes(identifiers)
- get_index_prices(identifier)
- get_index_constituents(identifier)

### Derivatives Data
- get_option_chain(identifier)
- get_option_prices(identifier)
- get_option_greeks(identifier)
- get_futures_symbols()
- get_futures_prices(identifier)

### Crypto Currencies
- get_crypto_symbols()
- get_crypto_information(identifier)
- get_crypto_quotes(identifiers)
- get_crypto_prices(identifier)
- get_crypto_minute_prices(identifier, date)

### Forex Data
- get_forex_symbols()
- get_forex_quotes(identifiers)
- get_forex_prices(identifier)
- get_forex_minute_prices(identifier, date)

### Basic Information
- get_company_information(identifier)
- get_international_company_information(identifier)
- get_key_metrics(identifier)
- get_market_cap(identifier)
- get_employee_count(identifier)
- get_executive_compensation(identifier)
- get_securities_information(identifier)

### Financial Statements
- get_income_statements(identifier, period=None)
- get_balance_sheet_statements(identifier, period=None)
- get_cash_flow_statements(identifier, period=None)
- get_international_income_statements(identifier, period=None)
- get_international_balance_sheet_statements(identifier, period=None)
- get_international_cash_flow_statements(identifier, period=None)

### Financial Ratios
- get_liquidity_ratios(identifier, period=None)
- get_solvency_ratios(identifier, period=None)
- get_efficiency_ratios(identifier, period=None)
- get_profitability_ratios(identifier, period=None)
- get_valuation_ratios(identifier, period=None)

### Market News
- get_press_releases(identifier)
- get_sec_press_releases(date)
- get_fed_press_releases(date)

### Event Calendars
- get_earnings_calendar(date)
- get_ipo_calendar(date)
- get_splits_calendar(date)
- get_dividends_calendar(date)
- get_economic_calendar(date)

### Insider Trading
- get_insider_transactions(identifier)
- get_proposed_sales(identifier)
- get_senate_trading(identifier)
- get_house_trading(identifier)

### Institutional Trading
- get_institutional_investors()
- get_institutional_holdings(identifier)
- get_institutional_portfolio_statistics(identifier)

### ETF Data
- get_etf_quotes(identifiers)
- get_etf_prices(identifier)
- get_etf_holdings(identifier)

### Mutual Funds

- get_mutual_fund_symbols()
- get_mutual_fund_holdings(identifier)
- get_mutual_fund_statistics(identifier)

### ESG Data
- get_esg_scores(identifier)
- get_esg_ratings(identifier)
- get_industry_esg_scores(date)

### Investment Advisers
- get_investment_adviser_names()
- get_investment_adviser_information(identifier)

### Miscellaneous Data
- get_earnings_releases(identifier)
- get_initial_public_offerings(identifier)
- get_stock_splits(identifier)
- get_dividends(identifier)
- get_short_interest(identifier)


## Return Values

All endpoint methods return lists of dictionaries parsed directly from the API JSON responses.

# API Documentation

#### Introduction

Here you can find a list of all API endpoints, along with their descriptions, required or optional query parameters, and sample responses.

When making requests, ensure that each URL ends with ?key=API\_KEY. If the URL already contains other query parameters, use &key=API\_KEY when adding the API key.

Some API endpoints may specify a limit on records to be retrieved per API call. To retrieve all the data available from these endpoints, use the offset parameter. For example, if the record limit is 500, then with the first API call, you will retrieve records 0–499, with the second API call records 500–999, etc.

For fast and easy integration into your applications, we recommend using our official [Python SDK](https://github.com/financialdatanet/fdnpy) (available on GitHub). It provides a straightforward way to access all API functionalities.

#### Stock Symbols <code>Free subscription</code>

Get a list of stock symbols for publicly traded US and international companies. The list contains thousands of trading symbols as well as the names of the companies whose shares they identify. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/stock-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "A",
      "registrant_name": "AGILENT TECHNOLOGIES, INC."
    },
    {
      "trading_symbol": "AA",
      "registrant_name": "Alcoa Corp"
    },
    {
      "trading_symbol": "AACB",
      "registrant_name": "Artius II Acquisition Inc."
    },
    ...
  ]
  ```

#### International Stock Symbols <code>Free subscription</code>

Retrieve a list of stock symbols for publicly traded international companies. Data is available for the following stock exchanges: Toronto, London, Frankfurt, Euronext Paris, Euronext Amsterdam, Tokyo, Hong Kong, Singapore, Indonesia, Malaysia, Korea, Brazil, Mexico, India, Bombay. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/international-stock-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "000080.KS",
      "registrant_name": "HiteJinro Co., Ltd."
    },
    {
      "trading_symbol": "000100.KS",
      "registrant_name": "Yuhan Corporation"
    },
    {
      "trading_symbol": "000120.KS",
      "registrant_name": "CJ Logistics Corporation"
    },
    ...
  ]
  ```

#### Etf Symbols <code>Free subscription</code>

An exchange-traded fund (ETF) is a type of investment fund that trades on the stock exchange. ETFs own financial assets such as stocks, bonds, currencies, futures contracts, or commodities. Our API can provide you with a list of a few thousand ETF trading symbols, together with their descriptions. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/etf-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "AAA",
      "description": "AAF First Priority CLO Bond ETF"
    },
    {
      "trading_symbol": "AADR",
      "description": "AdvisorShares Dorsey Wright ADR ETF"
    },
    {
      "trading_symbol": "AALL",
      "description": "GraniteShares 2x Long AAL Daily ETF"
    },
    ...
  ]
  ```

#### Commodity Symbols <code>Free subscription</code>

The commodity market covers the trading of raw materials like oil, gold, coffee, etc. This API endpoint provides trading symbols and additional information for major commodities.

- ###### Endpoint

  `https://financialdata.net/api/v1/commodity-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "BZ",
      "description": "Brent Crude Oil Futures (NYMEX)"
    },
    {
      "trading_symbol": "CJ",
      "description": "Cocoa Futures (NYMEX)"
    },
    {
      "trading_symbol": "CL",
      "description": "Crude Oil Futures (NYMEX)"
    },
    ...
  ]
  ```

#### Otc Symbols <code>Free subscription</code>

The over-the-counter (OTC) market is where securities are traded through a network of brokers and dealers rather than on a centralized exchange. OTC stocks typically indicate ownership of equity in smaller companies that do not meet the requirements for regular listings. Our API gives you access to thousands of OTC symbols and additional information about them. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/otc-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "AAALY",
      "title_of_security": "Aareal Bank AG Unsponsored American Depository Receipt (Germany)"
    },
    {
      "trading_symbol": "AABB",
      "title_of_security": "Asia Broadband Inc Common Stock"
    },
    {
      "trading_symbol": "AABVF",
      "title_of_security": "Aberdeen International Inc Ordinary Shares"
    },
    ...
  ]
  ```

#### Stock Quotes <code>Premium subscription</code>

Get real-time stock quotes, including the last price, change, and percentage change. The data covers several thousand US and international companies. The timezone used for time values is EST (Eastern Standard Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/stock-quotes?identifiers=MSFT,AAPL`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifiers | string | The trading symbols for the securities. | MSFT,AAPL |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "AAPL",
      "registrant_name": "Apple Inc.",
      "time": "2025-09-02 15:56:00",
      "price": 238.08,
      "change": 8.36,
      "percentage_change": 3.64
    },
    {
      "trading_symbol": "MSFT",
      "registrant_name": "MICROSOFT CORP",
      "time": "2025-09-02 15:55:57",
      "price": 502.42,
      "change": -2.7,
      "percentage_change": -0.53
    }
  ]
  ```

#### Stock Prices <code>Free subscription</code>

The API endpoint provides more than 10 years of daily historical stock prices and volumes. The data covers several thousand US and international companies. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/stock-prices?identifier=MSFT`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | MSFT |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "MSFT",
      "date": "2024-12-04",
      "open": 433.03,
      "high": 439.67,
      "low": 432.63,
      "close": 437.42,
      "volume": 26009430.0
    },
    {
      "trading_symbol": "MSFT",
      "date": "2024-12-03",
      "open": 429.84,
      "high": 432.47,
      "low": 427.74,
      "close": 431.2,
      "volume": 18301990.0
    },
    ...
  ]
  ```

#### International Stock Prices <code>Standard subscription</code>

Get more than 10 years of daily historical stock prices and volumes. Data is available for the following stock exchanges: Toronto, London, Frankfurt, Euronext Paris, Euronext Amsterdam, Tokyo, Hong Kong, Singapore, Indonesia, Malaysia, Korea, Brazil, Mexico, India, Bombay. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/international-stock-prices?identifier=SHEL.L`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | SHEL.L |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "SHEL.L",
      "date": "2025-05-02",
      "open": 2493.0,
      "high": 2543.5,
      "low": 2461.5,
      "close": 2486.5,
      "volume": 12476281.0
    },
    {
      "trading_symbol": "SHEL.L",
      "date": "2025-05-01",
      "open": 2405.0,
      "high": 2446.0,
      "low": 2373.0,
      "close": 2436.5,
      "volume": 4203522.0
    },
    ...
  ]
  ```

#### Minute Prices <code>Standard subscription</code>

The API endpoint provides more than 7 years of one-minute historical prices and volumes. The data is available for over 10,000 securities, including US stocks, international stocks, and exchange-traded funds. The timezone used for time values is UTC (Coordinated Universal Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/minute-prices?identifier=MSFT&date=2020-01-15`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | MSFT |
  | date | string | The date in YYYY-MM-DD format. | 2020-01-15 |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "MSFT",
      "time": "2020-01-15 20:59:00",
      "open": 163.14,
      "high": 163.26,
      "low": 163.1,
      "close": 163.25,
      "volume": 5633.0
    },
    {
      "trading_symbol": "MSFT",
      "time": "2020-01-15 20:58:00",
      "open": 163.065,
      "high": 163.18,
      "low": 163.055,
      "close": 163.145,
      "volume": 15777.0
    },
    ...
  ]
  ```

#### Latest Prices <code>Premium subscription</code>

Get one-minute stock prices and trading volumes for the current week. Data is available for more than 10,000 securities, including US stocks, international stocks, and exchange-traded funds (ETFs). The timezone used for time values is UTC (Coordinated Universal Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/latest-prices?identifier=MSFT`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | MSFT |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "MSFT",
      "time": "2025-11-04 20:59:00",
      "open": 514.74,
      "high": 514.89,
      "low": 514.38,
      "close": 514.71,
      "volume": 19328.0
    },
    {
      "trading_symbol": "MSFT",
      "time": "2025-11-04 20:58:00",
      "open": 514.36,
      "high": 514.74,
      "low": 514.33,
      "close": 514.74,
      "volume": 9980.0
    },
    ...
  ]
  ```

#### Commodity Prices <code>Free subscription</code>

The commodity market comprises the trading of raw materials such as oil, gold, coffee, etc. Our API offers over ten years of end-of-day historical prices and volumes for major commodities. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/commodity-prices?identifier=ZC`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a commodity. | ZC |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "ZC",
      "date": "2024-12-03",
      "open": 425.0,
      "high": 428.0,
      "low": 422.75,
      "close": 423.25,
      "volume": 4078.0
    },
    {
      "trading_symbol": "ZC",
      "date": "2024-12-02",
      "open": 423.0,
      "high": 425.5,
      "low": 420.75,
      "close": 424.5,
      "volume": 3877.0
    },
    ...
  ]
  ```

#### Otc Prices <code>Free subscription</code>

The over-the-counter (OTC) market is a market in which securities are traded through a network of brokers and dealers rather than on a centralized exchange. OTC stocks often represent ownership of equity in smaller companies that do not meet the requirements for regular listings. The API endpoint provides over ten years of daily historical prices and volumes for more than 10,000 OTC securities. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/otc-prices?identifier=AABB`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | AABB |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "AABB",
      "date": "2024-12-04",
      "open": 0.0271,
      "high": 0.0271,
      "low": 0.024,
      "close": 0.0248,
      "volume": 6592169.0
    },
    {
      "trading_symbol": "AABB",
      "date": "2024-12-03",
      "open": 0.0235,
      "high": 0.029,
      "low": 0.0235,
      "close": 0.0265,
      "volume": 6828867.0
    },
    ...
  ]
  ```

#### Otc Volume <code>Free subscription</code>

Over-the-counter (OTC) stocks typically represent ownership of equity in smaller companies that do not meet the criteria for regular listings. Some stocks may not be liquid at all. The API endpoint provides information about the monthly share volume traded for a certain security.

- ###### Endpoint

  `https://financialdata.net/api/v1/otc-volume?identifier=AABB`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security. | AABB |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "AABB",
      "title_of_security": "Asia Broadband Inc Common Stock",
      "month_start_date": "2024-10-01",
      "monthly_volume": 140366022,
      "previous_monthly_volume": 263720143,
      "volume_year_to_date": 2237440816
    },
    {
      "trading_symbol": "AABB",
      "title_of_security": "Asia Broadband Inc Common Stock",
      "month_start_date": "2024-09-01",
      "monthly_volume": 263720143,
      "previous_monthly_volume": 692420804,
      "volume_year_to_date": 2097074794
    },
    ...
  ]
  ```

#### Index Symbols <code>Standard subscription</code>

A market index measures the value of a portfolio of holdings with certain market characteristics. The API endpoint allows you to get a list of the trading symbols and names of the major market indexes.

- ###### Endpoint

  `https://financialdata.net/api/v1/index-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "000001.SS",
      "index_name": "SSE Composite Index"
    },
    {
      "trading_symbol": "DE000SLA30S3.SG",
      "index_name": "Solactive Equal Weight Canada Oil & Gas Index"
    },
    {
      "trading_symbol": "DX-Y.NYB",
      "index_name": "US Dollar Index"
    },
    ...
  ]
  ```

#### Index Quotes <code>Premium subscription</code>

Get real-time market index quotes, including the last price, change, and percentage change. The data covers major market indexes. The timezone used for time values is EST (Eastern Standard Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/index-quotes?identifiers=^GSPC,^DJI`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifiers | string | The trading symbols for the indexes. | ^GSPC,^DJI |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "^GSPC",
      "index_name": "S&P 500",
      "time": "2025-09-23 15:19:59",
      "price": 6656.92,
      "change": -36.83,
      "percentage_change": -0.55
    },
    {
      "trading_symbol": "^DJI",
      "index_name": "Dow Jones Industrial Average",
      "time": "2025-09-23 15:19:59",
      "price": 46292.78,
      "change": -88.76,
      "percentage_change": -0.19
    }
  ]
  ```

#### Index Prices <code>Standard subscription</code>

Our API allows you to retrieve more than 10 years of daily historical market index prices and trading volumes. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/index-prices?identifier=^GSPC`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for an index. | ^GSPC |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "^GSPC",
      "date": "2025-06-13",
      "open": 6000.56,
      "high": 6026.16,
      "low": 5963.21,
      "close": 5976.97,
      "volume": 5258910000.0
    },
    {
      "trading_symbol": "^GSPC",
      "date": "2025-06-12",
      "open": 6009.9,
      "high": 6045.43,
      "low": 6003.88,
      "close": 6045.26,
      "volume": 4669500000.0
    },
    ...
  ]
  ```

#### Index Constituents <code>Standard subscription</code>

Index constituents are the individual components that comprise a market index. These can be stocks, bonds, or other financial instruments. The API endpoint returns a list of constituents for a specific index. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/index-constituents?identifier=^GSPC`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for an index. | ^GSPC |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "^GSPC",
      "index_name": "S&P 500",
      "constituent_symbol": "COIN",
      "constituent_name": "Coinbase",
      "sector": "Financials",
      "industry": "Financial Exchanges & Data",
      "date_added": "2025-05-19"
    },
    {
      "trading_symbol": "^GSPC",
      "index_name": "S&P 500",
      "constituent_symbol": "DASH",
      "constituent_name": "DoorDash",
      "sector": "Consumer Discretionary",
      "industry": "Specialized Consumer Services",
      "date_added": "2025-03-24"
    },
    ...
  ]
  ```

#### Option Chain <code>Standard subscription</code>

Options chains display a list of all available option contracts for a specific underlying security. The API endpoint provides option chain data for several thousand US and international companies. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/option-chain?identifier=MSFT`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a security, or the central index key (CIK). The latter is assigned to the entity by the United States Securities and Exchange Commission. | MSFT, 0000789019 |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "MSFT",
      "central_index_key": "0000789019",
      "registrant_name": "MICROSOFT CORP",
      "contract_name": "MSFT271217P00660000",
      "expiration_date": "2027-12-17",
      "put_or_call": "Put",
      "strike_price": 660.0
    },
    {
      "trading_symbol": "MSFT",
      "central_index_key": "0000789019",
      "registrant_name": "MICROSOFT CORP",
      "contract_name": "MSFT271217C00660000",
      "expiration_date": "2027-12-17",
      "put_or_call": "Call",
      "strike_price": 660.0
    },
    ...
  ]
  ```

#### Option Prices <code>Standard subscription</code>

Stock options give the right to buy or sell shares of a specific stock at a predetermined price and date. The API endpoint provides daily historical stock option prices and volumes. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/option-prices?identifier=MSFT260123C00455000`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The contract name for a stock option. | MSFT260123C00455000 |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "contract_name": "MSFT250417C00400000",
      "date": "2025-03-07",
      "open": 11.45,
      "high": 11.9,
      "low": 8.75,
      "close": 11.25,
      "volume": 1005.0
    },
    {
      "contract_name": "MSFT250417C00400000",
      "date": "2025-03-06",
      "open": 11.65,
      "high": 16.0,
      "low": 11.5,
      "close": 13.86,
      "volume": 1299.0
    },
    ...
  ]
  ```

#### Option Greeks <code>Standard subscription</code>

Option Greeks provide a way to measure the sensitivity of an option's price to numerous factors such as the underlying asset price, time till expiration, market volatility, and so on. Our API provides daily historical option Greek values. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/option-greeks?identifier=MSFT260123C00455000`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The contract name for a stock option. | MSFT260123C00455000 |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "contract_name": "MSFT250417C00400000",
      "date": "2025-03-07",
      "delta": 0.163203703354078,
      "gamma": 0.000139524283246703,
      "theta": -0.0218808916622069,
      "vega": 0.324904955132613,
      "rho": 0.0716368104421749
    },
    {
      "contract_name": "MSFT250417C00400000",
      "date": "2025-03-06",
      "delta": 0.40771043689382,
      "gamma": 0.000216457024980538,
      "theta": -0.041187033759887,
      "vega": 0.52266727480074,
      "rho": 0.184554341455875
    },
    ...
  ]
  ```

#### Futures Symbols <code>Standard subscription</code>

Futures contracts are contracts to purchase or sell a particular underlying asset at a future date. The API endpoint returns a list of futures symbols along with their descriptions. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/futures-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "10Y",
      "description": "10-Year Yield Futures",
      "type": "Interest Rates"
    },
    {
      "trading_symbol": "1OZ",
      "description": "1-Ounce Gold Futures",
      "type": "Metals"
    },
    {
      "trading_symbol": "2GT",
      "description": "BTIC on E-mini Russell 2000 Growth Index Futures",
      "type": "Equities"
    },
    ...
  ]
  ```

#### Futures Prices <code>Standard subscription</code>

Get over 10 years of historical end-of-day futures prices and volumes. Data is available for major agricultural, energy, equity, FX, interest rate, and metal futures. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/futures-prices?identifier=ZN`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for a futures contract. | ZN |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "ZN",
      "date": "2025-03-07",
      "open": 110.81,
      "high": 111.28,
      "low": 110.47,
      "close": 110.55,
      "volume": 6317.0
    },
    {
      "trading_symbol": "ZN",
      "date": "2025-03-06",
      "open": 110.64,
      "high": 110.91,
      "low": 110.39,
      "close": 110.78,
      "volume": 6317.0
    },
    ...
  ]
  ```

#### Crypto Symbols <code>Standard subscription</code>

Cryptocurrency is a digital currency that is secured through cryptography and exists on decentralised networks utilising blockchain technology. The API endpoint returns a list of cryptocurrency pair symbols and related information. There is a limit of 500 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/crypto-symbols`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 500 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "1000CATUSD",
      "base_asset": "1000CAT",
      "quote_asset": "USD"
    },
    {
      "trading_symbol": "1000CHEEMSUSD",
      "base_asset": "1000CHEEMS",
      "quote_asset": "USD"
    },
    {
      "trading_symbol": "1000SATSUSD",
      "base_asset": "1000SATS",
      "quote_asset": "USD"
    },
    ...
  ]
  ```

#### Crypto Information <code>Standard subscription</code>

Retrieve basic information about the cryptocurrency, such as its market cap, total supply, ledger start date, and various other key facts. The API endpoint provides basic information for major cryptocurrencies.

- ###### Endpoint

  `https://financialdata.net/api/v1/crypto-information?identifier=BTC`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The symbol (code) for a cryptocurrency. | BTC |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "BTC",
      "crypto_name": "Bitcoin",
      "market_cap": 2275103042119.0,
      "fully_diluted_valuation": 2275103042119.0,
      "total_supply": 19900334.0,
      "max_supply": 21000000.0,
      "circulating_supply": 19900334.0,
      "highest_price": 122838.0,
      "highest_price_date": "2025-07-14",
      "lowest_price": 67.81,
      "lowest_price_date": "2013-07-06",
      "hash_function": "SHA-256",
      "block_time": "10 minutes",
      "ledger_start_date": "2009-01-03",
      "website": "http://www.bitcoin.org",
      "description": "Bitcoin is the first decentralized cryptocurrency, operating on a peer-to-peer network without central authority. It uses blockchain technology to enable secure, transparent transactions. Known as digital gold, Bitcoin has a capped supply of 21 million coins. Its primary use cases include store of value and cross-border payments. Mining secures the network through proof-of-work consensus."
    }
  ]
  ```

#### Crypto Quotes <code>Premium subscription</code>

Get real-time cryptocurrency pair quotes, including the last price, change, and percentage change. Change is the price difference within a 24-hour time frame. The timezone used for time values is UTC (Coordinated Universal Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/crypto-quotes?identifiers=BTCUSD,ETHUSD`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifiers | string | The trading symbols for the cryptocurrency pairs. | BTCUSD,ETHUSD |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "BTCUSD",
      "base_asset": "BTC",
      "quote_asset": "USD",
      "time": "2025-09-02 21:01:00",
      "price": 111394.68,
      "change": 2563.62,
      "percentage_change": 2.356
    },
    {
      "trading_symbol": "ETHUSD",
      "base_asset": "ETH",
      "quote_asset": "USD",
      "time": "2025-09-02 21:01:00",
      "price": 4314.39,
      "change": 27.29,
      "percentage_change": 0.637
    }
  ]
  ```

#### Crypto Prices <code>Standard subscription</code>

This API endpoint allows you to retrieve daily historical cryptocurrency prices and trading volumes. The data covers major cryptocurrency pairs. There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/crypto-prices?identifier=BTCUSD`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for the cryptocurrency pair. | BTCUSD |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Response

  ```json
  [
    {
      "trading_symbol": "BTCUSD",
      "date": "2025-07-30",
      "open": 117950.75,
      "high": 118792.0,
      "low": 115796.23,
      "close": 117840.3,
      "volume": 15586.73631
    },
    {
      "trading_symbol": "BTCUSD",
      "date": "2025-07-29",
      "open": 118062.32,
      "high": 119273.36,
      "low": 116950.75,
      "close": 117950.76,
      "volume": 15137.93445
    },
    ...
  ]
  ```

#### Crypto Minute Prices <code>Standard subscription</code>

The API endpoint allows you to retrieve one-minute historical cryptocurrency prices and volumes. The data covers major cryptocurrency pairs. The timezone used for time values is UTC (Coordinated Universal Time). There is a limit of 300 records per API call.

- ###### Endpoint

  `https://financialdata.net/api/v1/crypto-minute-prices?identifier=BTCUSD&date=2025-01-15`
- ###### Parameters

  | Name | Type | Description | Example |
  | --- | --- | --- | --- |
  | identifier | string | The trading symbol for the cryptocurrency pair. | BTCUSD |
  | date | string | The date in YYYY-MM-DD format. | 2025-01-15 |
  | offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. | 300 |
  | format | string | (Optional) The format of the returned data, either JSON (JavaScript Object Notation) or CSV (Comma Separated Values). Defaults to JSON. | json, csv |
- ###### Resp