GateData.AI
Guides

How to Get Company Fundamentals

Learn how to fetch company profiles, financial statements, and financial metrics using Python and the GateData.AI REST API.

This data domain is coming soon. Documentation is available now for reading and integration planning. REST and MCP try-it are disabled until this domain launches — paths and parameters will not change at GA.

Company fundamentals power valuation workflows, research dashboards, and agent tools. This guide walks through authentication and the core fundamentals endpoints.

Prerequisites

Step 1: Set Up Authentication

import requests

BASE_URL = "https://api.gatedata.ai/api"
headers = {
    "Authorization": "Bearer gd_live_xxx",
    "Accept": "application/json",
}

Step 2: Fetch Company Profile

Use GET /api/v1/fundamentals/profile for equities such as NVDA or AAPL.

ticker = "NVDA"
url = f"{BASE_URL}/v1/fundamentals/profile"
params = {"symbol": ticker}

response = requests.get(url, headers=headers, params=params)
profile = response.json()["data"]
print(profile["name"], profile.get("sector"), profile.get("market_cap"))

Step 3: Fetch Financial Statements

For income statements, balance sheets, and cash flows, use GET /api/v1/fundamentals/statements.

url = f"{BASE_URL}/v1/fundamentals/statements"
params = {
    "query": "AAPL",
    "statement_type": "income_statement",
    "period_type": "annual",
    "window": "last_3y",
}
response = requests.get(url, headers=headers, params=params)
statements = response.json()["data"]["statements"]
print(statements)

Step 4: Fetch Financial Metrics

Profitability, growth, leverage, and liquidity metrics are available via GET /api/v1/fundamentals/metrics .

url = f"{BASE_URL}/v1/fundamentals/metrics"
params = {"query": "AAPL", "metric_set": "profitability", "window": "latest"}
response = requests.get(url, headers=headers, params=params)
metrics = response.json()["data"]["metrics"]
print(metrics)

Filtering by Date Range

Historical fundamentals support start_date and end_date query parameters:

params = {
    "symbol": "NVDA",
    "start_date": "2023-01-01",
    "end_date": "2024-12-31",
}
response = requests.get(f"{BASE_URL}/v1/fundamentals/profile", headers=headers, params=params)

Available Tickers

Free-tier sample symbols include BTC, ETH, SOL, AAPL, NVDA, and TSLA. Browse the full catalog in the Data Catalog.

Next Steps