EODHD Financial APIs

https://eodhd.com/financial-apis
Admin
EODHD Financial APIs offers comprehensive historical and real-time financial market data,...
Tokens:255,481
Snippets:2,433
Trust Score:9.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### Request Example URL

Source: https://eodhd.com/financial-apis/interest-rates-api-sofr-fed-funds-ecb-boe-policy-rates

An example URL demonstrating filtering by central bank and start date.

```text
https://eodhd.com/api/rates/policy-rates?api_token=YOUR_TOKEN&filter[central_bank]=ECB&filter[from]=2025-01-01
```

--------------------------------

### Manual Setup for EODHD Claude Skills

Source: https://eodhd.com/financial-apis/eodhd-claude-skills-teach-your-ai-assistant-the-entire-financial-api

Alternative installation method by cloning the repository and setting the API token.

```bash
git clone https://github.com/EodHistoricalData/eodhd-claude-skills.git
export EODHD_API_TOKEN="your_token_here"
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/asx-australia-corporate-actions-beta

A sample GET request URL for retrieving dividend data for a specific symbol.

```text
https://eodhd.com/api/asx-corporate-actions?api_token=YOUR_TOKEN&type=dividends&symbol=PMV.AU&fmt=json
```

--------------------------------

### Install websocat via Homebrew

Source: https://eodhd.com/financial-apis/new-real-time-data-api-websockets

Command to install the websocat utility on macOS.

```bash
brew install websocat
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits

A direct URL request example for the IPOs calendar.

```text
https://eodhd.com/api/calendar/ipos?from=2025-01-01&to=2025-01-31&api_token={YOUR_API_TOKEN}&fmt=json
```

--------------------------------

### Request Example cURL

Source: https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits

A command-line request example using cURL.

```bash
curl --location "https://eodhd.com/api/calendar/ipos?from=2025-01-01&to=2025-01-31&api_token={YOUR_API_TOKEN}&fmt=json"
```

--------------------------------

### Request example URL

Source: https://eodhd.com/financial-apis/list-supported-crypto-currencies

Example URL request for specific cryptocurrency symbols.

```text
https://eodhd.com/api/exchange-symbol-list/CC?api_token=demo&fmt=json&symbols=BTC-USD,ETH-USD
```

--------------------------------

### cURL Request Example

Source: https://eodhd.com/financial-apis/sanctions-api-ofac-screening-data-entities-vessels

A command-line example to fetch sanctioned entities using cURL.

```bash
curl --location "https://eodhd.com/api/sanctions/entities?api_token=YOUR_TOKEN&program=RUSSIA-EO14024&type=entity&fmt=json"
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/sanctions-api-ofac-screening-data-entities-vessels

An example URL request filtered by the flag parameter.

```text
https://eodhd.com/api/sanctions/vessels?api_token=YOUR_TOKEN&flag=Panama
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example URL for requesting CDS spreads for France.

```text
https://eodhd.com/api/credit-risk/sovereign/cds-spreads?api_token=YOUR_TOKEN&filter[country]=France
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/commodities-api

A basic URL request example for WTI commodity data with monthly interval.

```text
https://eodhd.com/api/commodities/historical/WTI?api_token=demo&interval=monthly
```

--------------------------------

### Get Ticker List via Python

Source: https://eodhd.com/financial-apis/covered-tickers-eodhd

A Python example using the requests library to fetch the ticker list.

```python
import requests

url = f'https://eodhd.com/api/exchange-symbol-list/{EXCHANGE_CODE}?api_token={YOUR_API_TOKEN}&fmt=json'
data = requests.get(url).json()

print(data)
```

--------------------------------

### Install EODHD SDKs

Source: https://eodhd.com/financial-apis/quick-start-with-our-financial-data-apis

Commands to install the official EODHD SDKs for Python and Node.js.

```bash
pip install eodhd          # Python
npm install eodhd-apis     # Node.js / TypeScript
```

--------------------------------

### Quick Start Live OHLCV Request

Source: https://eodhd.com/financial-apis/bulk-for-live-ohlcv-stock-prices-api-us-exchanges-only

The basic GET request structure for the Live OHLCV API using the bulk 'ex=US' parameter.

```http
GET https://eodhd.com/api/real-time/AAPL.US?ex=US
```

--------------------------------

### Request Example R

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example R implementation using httr and jsonlite to fetch CDS spreads for France.

```r
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/credit-risk/sovereign/cds-spreads?api_token=YOUR_TOKEN&filter[country]=France&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}
```

--------------------------------

### Request Example cURL

Source: https://eodhd.com/financial-apis/interest-rates-api-sofr-fed-funds-ecb-boe-policy-rates

Example cURL command to fetch funding stress data.

```bash
curl --location "https://eodhd.com/api/spreads/funding-stress?api_token=YOUR_TOKEN&filter[code]=EFFR_SOFR,OBFR_EFFR&filter[from]=2026-05-01&filter[to]=2026-05-31&fmt=json"
```

--------------------------------

### Request URL Example

Source: https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta

A basic URL request example including the API token and year filter.

```text
https://eodhd.com/api/ust/yield-rates?api_token=YOUR_TOKEN&filter[year]=2023
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/interest-rates-api-sofr-fed-funds-ecb-boe-policy-rates

Example URL for querying specific spread codes within a date range.

```text
https://eodhd.com/api/spreads/funding-stress?api_token=YOUR_TOKEN&filter[code]=EFFR_SOFR,OBFR_EFFR&filter[from]=2026-05-01&filter[to]=2026-05-31
```

--------------------------------

### cURL Request Example

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example command to fetch default spreads using cURL.

```bash
curl --location "https://eodhd.com/api/credit-risk/sovereign/default-spreads?api_token=YOUR_TOKEN&filter[rating]=Aaa&fmt=json"
```

--------------------------------

### Request Example Python

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example Python implementation using the requests library to fetch CDS spreads for France.

```python
import requests

url = f'https://eodhd.com/api/credit-risk/sovereign/cds-spreads?api_token=YOUR_TOKEN&filter[country]=France&fmt=json'
data = requests.get(url).json()

print(data)
```

--------------------------------

### Request Example PHP

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example PHP implementation using cURL to fetch CDS spreads for France.

```php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/credit-risk/sovereign/cds-spreads?api_token=YOUR_TOKEN&filter[country]=France&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example URL demonstrating the use of the filter[rating] parameter to query a specific rating.

```text
https://eodhd.com/api/credit-risk/sovereign/default-spreads?api_token=YOUR_TOKEN&filter[rating]=Aaa
```

--------------------------------

### Response Example for 10-K Filings

Source: https://eodhd.com/financial-apis/sec-filings-api

Example JSON response structure containing filing metadata and financial metrics.

```json
{
  "data": [
    {
      "accession_number": "0000320193-25-000079",
      "filed_at": "2025-10-31",
      "period_of_report": "2025-09-27",
      "fiscal_year_end": "2025-09-27T00:00:00.000000Z",
      "revenue": 416161000000,
      "net_income": 112010000000,
      "eps_diluted": 7.46,
      "total_assets": 359241000000,
      "operating_cash_flow": 111482000000,
      "free_cash_flow": 98767000000
    }
  ],
  "meta": { "total": 11, "page": { "offset": 0, "limit": 20 } },
  "links": { "next": null }
}
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/insider-transactions-api

A basic URL request example for the Form 4 endpoint.

```text
https://eodhd.com/api/sec-filings/AAPL/form4?api_token=YOUR_TOKEN
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/id-mapping-api-cusip-isin-figi-lei-cik-%E2%86%94-symbol

A direct URL request example for the ID Mapping API using a symbol filter.

```text
https://eodhd.com/api/id-mapping?filter[symbol]=AAPL.US&page[limit]=100&page[offset]=0&api_token=YOUR_API_TOKEN&fmt=json
```

--------------------------------

### Filing Overview Response Example

Source: https://eodhd.com/financial-apis/sec-filings-api

Example JSON response showing company identification and filing counts by form type.

```json
{
  "data": {
    "ticker": "AAPL",
    "exchange": "US",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "filings": {
      "10k":   { "count": 11,  "latest": "2025-10-31", "url": "https://eodhd.com/api/sec-filings/AAPL.US/10k" },
      "10q":   { "count": 34,  "latest": "2026-05-01", "url": "https://eodhd.com/api/sec-filings/AAPL.US/10q" },
      "8k":    { "count": 107, "latest": "2026-04-30", "url": "https://eodhd.com/api/sec-filings/AAPL.US/8k" },
      "form4": { "count": 597, "latest": "2026-06-17", "url": "https://eodhd.com/api/sec-filings/AAPL.US/form4" }
    }
  }
}
```

--------------------------------

### Request Example R

Source: https://eodhd.com/financial-apis/interest-rates-api-sofr-fed-funds-ecb-boe-policy-rates

Example R code using httr and jsonlite to fetch funding stress data.

```r
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/spreads/funding-stress?api_token=YOUR_TOKEN&filter[code]=EFFR_SOFR,OBFR_EFFR&filter[from]=2026-05-01&filter[to]=2026-05-31&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}
```

--------------------------------

### Install WebSocket dependency

Source: https://eodhd.com/financial-apis/node-js-typescript-sdk-for-eodhd-financial-apis

Install the optional ws peer dependency required for WebSocket streaming in Node.js.

```bash
npm install ws
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/real-estate-data-api

An example URL for requesting detailed property data for the United States with a property type filter.

```text
https://eodhd.com/api/real-estate/US/detailed?api_token=YOUR_TOKEN&filter[property_type]=1
```

--------------------------------

### Java Example for Stock Data API

Source: https://eodhd.com/financial-apis-blog/category/code-examples

A Java example demonstrating how to download stock data using the EOD Historical Data API. The provided code is part of the EODHistoricalDataDownloader.java file.

```java
// Example Java code for EODHistoricalDataDownloader
// This is a conceptual representation, actual implementation may vary.

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class EODHistoricalDataDownloader {

    private static final String API_KEY = "YOUR_API_KEY";
    private static final String BASE_URL = "https://eodhistoricaldata.com/api/eod/";

    public static void main(String[] args) {
        String symbol = "AAPL";
        try {
            String data = downloadStockData(symbol);
            System.out.println(data);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static String downloadStockData(String symbol) throws Exception {
        String urlString = BASE_URL + symbol + ".US?api_token=" + API_KEY + "&fmt=json";
        URL url = new URL(urlString);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");

        BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        StringBuilder response = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();
        conn.disconnect();

        return response.toString();
    }
}
```

--------------------------------

### Get All Indices Starting with 'A'

Source: https://eodhd.com/financial-apis-blog/types-feature-for-search-api

Example of how to filter search results to retrieve all indices whose ticker starts with the letter 'A'.

```http
https://eodhistoricaldata.com/api/search/A?api_token=YOUR_API_TOKEN&fmt=json&type=index
```

--------------------------------

### Initialize APIClient with a configuration file

Source: https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples

Store the API key in a separate configuration file and import it into the main application.

```python
# config.py

API_KEY = "<Your_API_Key>"

# main.py
import config as cfg
api = APIClient(cfg.API_KEY)
```

--------------------------------

### GET /api/symbol-change-history

Source: https://eodhd.com/financial-apis/us-stock-symbol-rename-history-api

Retrieves a list of US stock symbol changes starting from a specified date.

```APIDOC
## GET /api/symbol-change-history

### Description
Retrieves the history of US stock ticker symbol changes. This endpoint helps in reconciling portfolios and maintaining historical data continuity.

### Method
GET

### Endpoint
https://eodhd.com/api/symbol-change-history

### Parameters
#### Query Parameters
- **from** (string) - Required - The start date for the history in YYYY-MM-DD format.
- **api_token** (string) - Required - Your unique API authentication token.
- **fmt** (string) - Optional - The response format, e.g., 'json'.

### Response
#### Success Response (200)
- **exchange** (string) - The exchange code (e.g., 'US').
- **old_symbol** (string) - The previous ticker symbol.
- **new_symbol** (string) - The new ticker symbol.
- **company_name** (string) - The name of the company.
- **effective** (string) - The date the symbol change became effective.

#### Response Example
[
  {
    "exchange": "US",
    "old_symbol": "BITF",
    "new_symbol": "KEEL",
    "company_name": "Keel Infrastructure Corp. Common Stock",
    "effective": "2026-04-06"
  }
]
```

--------------------------------

### Get Ticker List via cURL

Source: https://eodhd.com/financial-apis/covered-tickers-eodhd

A command-line example to retrieve the ticker list using cURL.

```bash
curl --location "https://eodhd.com/api/exchange-symbol-list/{EXCHANGE_CODE}?api_token={YOUR_API_TOKEN}&fmt=json"
```

--------------------------------

### Initialize APIClient with a direct key

Source: https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples

Create an instance of the APIClient class using a hardcoded API key.

```python
api = APIClient("<Your_API_Key>")
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/sanctions-api-ofac-screening-data-entities-vessels

A sample URL for querying sanctioned entities filtered by program and type.

```text
https://eodhd.com/api/sanctions/entities?api_token=YOUR_TOKEN&program=RUSSIA-EO14024&type=entity
```

--------------------------------

### Get Ticker List via R

Source: https://eodhd.com/financial-apis/covered-tickers-eodhd

An R example using httr and jsonlite to retrieve and display the ticker list.

```r
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/exchange-symbol-list/{EXCHANGE_CODE}?api_token={YOUR_API_TOKEN}&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}
```

--------------------------------

### Initialize APIClient with environment variables

Source: https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples

Retrieve the API key from system environment variables to initialize the client.

```python
import os

api_key = os.environ.get("<Your_API_Key>")
api = APIClient(api_key)
```

--------------------------------

### Request Congressional Trades via API

Source: https://eodhd.com/financial-apis-blog/introducing-the-congressional-trades-api

Example of a GET request to the Congressional Trades endpoint, filtering by chamber and ticker symbol using an API token.

```http
https://eodhd.com/api/congressional-trades?api_token=YOUR_TOKEN&chamber=senate&symbol=NVDA
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/real-estate-data-api

A sample URL demonstrating the use of filters for type, metric, and date range.

```text
https://eodhd.com/api/real-estate/US?api_token=YOUR_TOKEN&filter[type]=nominal&filter[metric]=index&filter[from]=2020-Q1&filter[to]=2024-Q4
```

--------------------------------

### Response Example JSON

Source: https://eodhd.com/financial-apis/api-for-historical-data-and-volumes

A sample JSON response containing daily price data.

```json
[
  {
    "date": "2024-01-02",
    "open": 295.05,
    "high": 297.28,
    "low": 295.05,
    "close": 297.04,
    "adjusted_close": 279.9221,
    "volume": 4458400
  },
  {
    "date": "2024-01-03",
    "open": 297,
    "high": 297.99,
    "low": 294.25,
    "close": 294.39,
    "adjusted_close": 277.4248,
    "volume": 3114800
  }
]
```

--------------------------------

### SEC Filings API GET requests

Source: https://eodhd.com/financial-apis-blog/sec-filings-api

Examples of using curl to retrieve filing overviews, 10-K annual reports, and 8-K material events for a ticker. Replace YOUR_API_TOKEN with your actual API key.

```bash
# Filing overview for Apple
curl "https://eodhd.com/api/sec-filings/AAPL.US?api_token=YOUR_API_TOKEN&fmt=json"

# Latest annual reports (10-K)
curl "https://eodhd.com/api/sec-filings/AAPL.US/10k?api_token=YOUR_API_TOKEN&fmt=json"

# Material events (8-K)
curl "https://eodhd.com/api/sec-filings/AAPL.US/8k?api_token=YOUR_API_TOKEN&fmt=json"
```

--------------------------------

### Request Filing Overview via Python

Source: https://eodhd.com/financial-apis/sec-filings-api

Python implementation using the requests library to fetch and print the filing overview.

```python
import requests

url = f'https://eodhd.com/api/sec-filings/AAPL.US?api_token=YOUR_API_TOKEN&fmt=json'
data = requests.get(url).json()

print(data)
```

--------------------------------

### Install EODHD package

Source: https://eodhd.com/financial-apis/node-js-typescript-sdk-for-eodhd-financial-apis

Install the core EODHD library via npm.

```bash
npm install eodhd
```

--------------------------------

### Request Example PHP

Source: https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits

A PHP implementation using the cURL library to fetch IPO data.

```php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/calendar/ipos?from=2025-01-01&to=2025-01-31&api_token={YOUR_API_TOKEN}&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}
```

--------------------------------

### Request Example URL

Source: https://eodhd.com/financial-apis/bulk-for-live-ohlcv-stock-prices-api-us-exchanges-only

A sample URL for the bulk API request including the API token and JSON format parameter.

```text
https://eodhd.com/api/real-time/AAPL.US?ex=US&api_token=demo&fmt=json
```

--------------------------------

### Excel VBA Example for Fundamentals Data

Source: https://eodhd.com/financial-apis-blog/category/code-examples

An updated Excel VBA example demonstrating how to work with fundamentals data feed, including JSON output. This example is suitable for newer versions of Excel.

```vba
Sub UpdateFundamentals()
    ' Example VBA code for updating fundamentals data
    ' Requires VBA-JSON library
    Dim jsonResponse As String
    Dim data As Object
    
    ' Replace with your actual API call logic
    ' jsonResponse = EODHD_API_Call("fundamentals", "AAPL") 
    
    ' Set jsonResponse to a sample JSON string for demonstration
    jsonResponse = "{\"symbol\": \"AAPL\", \"financials\": { \"income_statement\": [ { \"date\": \"2023-09-30\", \"revenue\": 89499000000 } ] }}"
    
    Set data = ParseJson(jsonResponse)
    
    ' Process the data object
    ' Example: Debug.Print data("financials").income_statement(1).revenue
    
End Sub

Function ParseJson(jsonString As String) As Object
    ' Placeholder for JSON parsing function using VBA-JSON library
    ' In a real scenario, you would use JsonConverter.Parse(jsonString)
    Set ParseJson = CreateObject("Scripting.Dictionary") ' Dummy object
End Function
```

--------------------------------

### Request URL Example

Source: https://eodhd.com/financial-apis/fundamental-data-for-cryptocurrencies

A direct URL request for Bitcoin (BTC-USD) fundamental data using the demo API token.

```text
https://eodhd.com/api/fundamentals/BTC-USD.CC?api_token=demo&fmt=json
```

--------------------------------

### Request URL Example

Source: https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta

Example URL for requesting long-term rates for the year 2020.

```text
https://eodhd.com/api/ust/long-term-rates?api_token=YOUR_TOKEN&filter[year]=2020
```

--------------------------------

### Request Filing Overview via R

Source: https://eodhd.com/financial-apis/sec-filings-api

R implementation using httr and jsonlite to fetch and display the filing overview.

```r
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/sec-filings/AAPL.US?api_token=YOUR_API_TOKEN&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}
```

--------------------------------

### Request Example R

Source: https://eodhd.com/financial-apis/cboe-europe-indices-api-beta

An R implementation using httr and jsonlite to fetch and display the index data.

```r
library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/cboe/indices?api_token=DEMO&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}
```

--------------------------------

### Request Example cURL

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example cURL command to fetch CDS spreads for France.

```bash
curl --location "https://eodhd.com/api/credit-risk/sovereign/cds-spreads?api_token=YOUR_TOKEN&filter[country]=France&fmt=json"
```

--------------------------------

### Response Format Example

Source: https://eodhd.com/financial-apis/interest-rates-api-sofr-fed-funds-ecb-boe-policy-rates

Example JSON response structure for the funding stress endpoint.

```json
{
  "data": [
    {
      "date": "2026-06-22",
      "code": "EFFR_SOFR",
      "value_bps": 2,
      "formula": "EFFR - SOFR",
      "leg_a": "EFFR",
      "leg_b": "SOFR",
      "leg_a_rate": 3.63,
      "leg_b_rate": 3.61
    },
    {
      "date": "2026-06-22",
      "code": "SOFR_TARGET_LOWER",
      "value_bps": 11,
      "formula": "SOFR - FED_TARGET_LOWER",
      "leg_a": "SOFR",
      "leg_b": "FED_TARGET_LOWER",
      "leg_a_rate": 3.61,
      "leg_b_rate": 3.5
    }
  ],
  "meta": { "total": 6 },
  "links": []
}
```

--------------------------------

### SEC Company Directory Response Example

Source: https://eodhd.com/financial-apis/sec-company-analytics-api

Example JSON response structure for the /api/sec-companies endpoint.

```json
{
  "data": [
    {
      "cik": "0001084869",
      "name": "1-800-FLOWERS.COM, Inc.",
      "ticker": "FLWS",
      "exchange": "US",
      "sic_code": "5990",
      "state_of_incorporation": "DE",
      "fiscal_year_end": "0630",
      "tickers": [ { "ticker": "FLWS", "exchange": "US", "is_primary": true } ]
    }
  ],
  "meta": { "total": 5939, "page": { "offset": 0, "limit": 20 } },
  "links": { "next": "https://eodhd.com/api/sec-companies?page[offset]=20&page[limit]=20" }
}
```

--------------------------------

### cURL Request Example

Source: https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta

Example cURL command to fetch long-term rates in JSON format.

```bash
curl --location "https://eodhd.com/api/ust/long-term-rates?api_token=YOUR_TOKEN&filter[year]=2020&fmt=json"
```

--------------------------------

### Output Format Example

Source: https://eodhd.com/financial-apis/cboe-europe-indices-api-beta

A sample JSON response structure showing index attributes like region, index_code, and closing values.

```json
...
{
"id": "BAT20P",
"type": "cboe-index",
"attributes": {
"region": "Austria",
"index_code": "BAT20P",
"feed_type": "snapshot_official_closing",
"date": "2017-04-12",
"index_close": 10549.68,
"index_divisor": 4269150.786625
}
},
{
"id": "BDE30P",
"type": "cboe-index",
"attributes": {
"region": "Germany",
"index_code": "BDE30P",
"feed_type": "snapshot_official_closing",
"date": "2017-02-01",
"index_close": 13915.57,
"index_divisor": 68033376.886244
}
},
{
"id": "BDES50N",
"type": "cboe-index",
"attributes": {
"region": "Germany",
"index_code": "BDES50N",
"feed_type": "snapshot_official_closing",
"date": "2017-02-01",
"index_close": 20143.79,
"index_divisor": 2246357.472101
}
...
```

--------------------------------

### Response Example JSON

Source: https://eodhd.com/financial-apis/credit-and-sovereign-risk-data-api

Example JSON response structure containing sovereign CDS data.

```json
{
  "data": [
    {
      "country_iso3": "FRA",
      "country_name": "France",
      "as_of_date": "2026-01-01T00:00:00+00:00",
      "moodys_rating": "Aa3",
      "cds_spread": 0.0035,
      "cds_spread_net_of_switzerland": 0.0028,
      "source": "damodaran"
    }
  ],
  "meta": {
    "total": 157,
    "page": { "offset": 0, "limit": 20 },
    "dataset": "sovereign_cds_spread",
    "source": "damodaran",
    "frequency": "annual",
    "attribution": "Damodaran, NYU Stern (annual). Sovereign 10Y CDS spreads where the market is liquid; NULL where no liquid market."
  },
  "links": { "next": "https://eodhd.com/api/credit-risk/sovereign/cds-spreads?page[offset]=20&page[limit]=20" }
}
```

--------------------------------

### Splits Data JSON Response Example

Source: https://eodhd.com/financial-apis/bulk-api-eod-splits-dividends/.

Example of the JSON structure returned by the splits API.

```json
[
    {
        "code": "CXAI",
        "exchange": "US",
        "date": "2026-08-18",
        "split": "1.000000/50.000000"
    },
    {
        "code": "LNOK",
        "exchange": "US",
        "date": "2026-08-18",
        "split": "2.000000/1.000000"
    }
]
```

--------------------------------

### Install EODHD library

Source: https://eodhd.com/financial-apis/python-financial-libraries-and-code-samples

Use pip to install or upgrade the official EODHD Python library.

```bash
python3 -m pip install eodhd -U
```

--------------------------------

### Request Example Python

Source: https://eodhd.com/financial-apis/cboe-europe-indices-api-beta

A Python implementation using the requests library to fetch and print the index data.

```python
import requests

url = f'https://eodhd.com/api/cboe/indices?api_token=DEMO&fmt=json'
data = requests.get(url).json()

print(data)
```
Tokens:
Raw