Tida Trading API - US Stock Market Data API

Authentication

All requests require your API key. Include it in every request as a query parameter.

API Key

Your API key is provided when you sign up. Include it in all requests using theapi_key query parameter.

https://api.tidatrading.com/v1/health?api_key=YOUR_API_KEY

Companies

Search and retrieve company information, profiles, and metadata.

GET

/v1/companies/search

Search companies by name, ticker, or CIK

Parameters

Name	Type	Required	Description
query	string	Required	Search term
exchange	string	Optional	Filter by exchange
limit	number	Optional	Max results (default: 20)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/companies/search?query=apple&exchange=NASDAQ&limit=20&api_key=YOUR_API_KEY

GET

/v1/companies/{symbol}

Get company profile by ticker symbol

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/companies/AAPL?api_key=YOUR_API_KEY

GET

/v1/companies

List all companies with filters

Parameters

Name	Type	Required	Description
exchange	string	Optional	Filter by exchange
sector	string	Optional	Filter by sector
limit	number	Optional	Results per page (default: 20)
offset	number	Optional	Pagination offset
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/companies?exchange=NASDAQ&sector=Technology&limit=20&offset=0&api_key=YOUR_API_KEY

Fundamentals

Retrieve financial statements, ratios, metrics, and intrinsic value calculations.

GET

/v1/fundamentals/{symbol}/income-statement

Get income statements

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
period	string	Optional	Period type: annual or quarterly
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/income-statement?period=annual&api_key=YOUR_API_KEY

GET

/v1/fundamentals/{symbol}/balance-sheet

Get balance sheets

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
period	string	Optional	Period type: annual or quarterly
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/balance-sheet?period=annual&api_key=YOUR_API_KEY

GET

/v1/fundamentals/{symbol}/ratios

Get financial ratios

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/ratios?api_key=YOUR_API_KEY

GET

/v1/fundamentals/{symbol}/cash-flow

Get cash flow statements (annual and quarterly)

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
period	string	Optional	Period type: annual or quarterly
from_date	string	Optional	Start date filter (YYYY-MM-DD)
to_date	string	Optional	End date filter (YYYY-MM-DD)
limit	number	Optional	Max results (default: 10)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/cash-flow?period=annual&from_date=2020-01-01&to_date=2024-12-31&limit=10&api_key=YOUR_API_KEY

GET

/v1/fundamentals/{symbol}/metrics

Get derived financial metrics

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
period	string	Optional	Period type: annual or quarterly
from_date	string	Optional	Start date filter (YYYY-MM-DD)
to_date	string	Optional	End date filter (YYYY-MM-DD)
limit	number	Optional	Max results (default: 5)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/metrics?period=annual&from_date=2020-01-01&to_date=2024-12-31&limit=5&api_key=YOUR_API_KEY

GET

/v1/fundamentals/{symbol}/intrinsic-value

Get intrinsic value calculations using multiple models

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/fundamentals/AAPL/intrinsic-value?api_key=YOUR_API_KEY

Stock Prices

Get end-of-day prices, historical data, and price forecasts.

GET

/v1/prices/eod/{symbol}

Get end-of-day stock prices

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/prices/eod/AAPL?api_key=YOUR_API_KEY

GET

/v1/prices/historical/{symbol}

Get historical stock prices

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
from_date	string	Optional	Start date (YYYY-MM-DD)
to_date	string	Optional	End date (YYYY-MM-DD)
limit	number	Optional	Max records (default: 1000, max: 10000)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/prices/historical/AAPL?from_date=2024-01-01&to_date=2024-12-31&limit=1000&api_key=YOUR_API_KEY

GET

/v1/prices/forecast/{symbol}

Get 12-month price forecasts

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/prices/forecast/AAPL?api_key=YOUR_API_KEY

Institutional Holdings

Retrieve institutional holdings data from SEC Form 13F filings.

GET

/v1/holdings/institutional/{symbol}

Get institutional holdings for a company

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
from_date	string	Optional	Start date filter (YYYY-MM-DD)
to_date	string	Optional	End date filter (YYYY-MM-DD)
limit	number	Optional	Max results (default: 20)
offset	number	Optional	Pagination offset
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/holdings/institutional/AAPL?from_date=2024-01-01&to_date=2024-12-31&limit=20&offset=0&api_key=YOUR_API_KEY

GET

/v1/holdings/institutions/{cik}

Get all holdings for a specific institutional investor

Parameters

Name	Type	Required	Description
cik	string	Required	Institutional investor CIK (10 digits)
from_date	string	Optional	Start date filter (YYYY-MM-DD)
to_date	string	Optional	End date filter (YYYY-MM-DD)
limit	number	Optional	Max results (default: 20)
offset	number	Optional	Pagination offset
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/holdings/institutions/0001067983?from_date=2024-01-01&to_date=2024-12-31&limit=20&offset=0&api_key=YOUR_API_KEY

Bulk Data

Download large datasets in parts using CSV or JSON format.

GET

/v1/bulk/companies

Download all companies data (requires parts-based download)

Parameters

Name	Type	Required	Description
format	string	Optional	Response format: csv or json (default: csv)
exchange	string	Optional	Filter by exchange
sector	string	Optional	Filter by sector
part	number	Required	Part number to retrieve (1-based, required)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/bulk/companies?format=csv&exchange=NASDAQ&sector=Technology&part=1&api_key=YOUR_API_KEY

GET

/v1/bulk/fundamentals/{type}

Download financial statements by type (requires parts-based download)

Parameters

Name	Type	Required	Description
type	string	Required	Statement type: income, balance, or cashflow
format	string	Optional	Response format: csv or json (default: csv)
part	number	Required	Part number to retrieve (1-based, required)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/bulk/fundamentals/income?format=csv&part=1&api_key=YOUR_API_KEY

GET

/v1/bulk/holdings/institutional

Download institutional holdings data (requires parts-based download)

Parameters

Name	Type	Required	Description
format	string	Optional	Response format: csv or json (default: csv)
part	number	Required	Part number to retrieve (1-based, required)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/bulk/holdings/institutional?format=csv&part=1&api_key=YOUR_API_KEY

GET

/v1/bulk/insiders/transactions

Download insider transactions data (requires parts-based download)

Parameters

Name	Type	Required	Description
format	string	Optional	Response format: csv or json (default: csv)
part	number	Required	Part number to retrieve (1-based, required)
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/bulk/insiders/transactions?format=csv&part=1&api_key=YOUR_API_KEY

Health Check

Check API health status.

GET

/v1/health

Check API health status

Parameters

Name	Type	Required	Description
api_key	string	Required	Your API key

Example Request

https://api.tidatrading.com/v1/health?api_key=YOUR_API_KEY

Rate Limits

Plan Comparison

Feature	Basic (Free)	Premium
Requests/Day	250	~1.44M (theoretical)
Requests/Minute	~0.17	1,000
Monthly Bandwidth	500 MB	50 GB
Concurrent Requests	5	50

Rate Limit Headers

All API responses include rate limit headers to help you track your usage:

X-RateLimit-Limit: Maximum requests allowed
X-RateLimit-Remaining: Remaining requests in current period
X-RateLimit-Reset: Timestamp when the limit resets

Code Examples

JavaScript/TypeScript

JavaScript

// Fetch company profile
const response = await fetch(
  'https://api.tidatrading.com/v1/companies/AAPL?api_key=YOUR_API_KEY'
);
const company = await response.json();

// Fetch income statement
const incomeResponse = await fetch(
  'https://api.tidatrading.com/v1/fundamentals/AAPL/income-statement?api_key=YOUR_API_KEY'
);
const incomeStatement = await incomeResponse.json();

Python

import requests

# Fetch company profile
response = requests.get(
    'https://api.tidatrading.com/v1/companies/AAPL',
    params={'api_key': 'YOUR_API_KEY'}
)
company = response.json()

# Fetch income statement
income_response = requests.get(
    'https://api.tidatrading.com/v1/fundamentals/AAPL/income-statement',
    params={'api_key': 'YOUR_API_KEY'}
)
income_statement = income_response.json()

Error Handling

JavaScript

try {
  const response = await fetch(
    'https://api.tidatrading.com/v1/companies/AAPL?api_key=YOUR_API_KEY'
  );
  
  if (!response.ok) {
    if (response.status === 429) {
      console.error('Rate limit exceeded');
    } else if (response.status === 401) {
      console.error('Invalid API key');
    } else {
      const error = await response.json();
      console.error('API Error:', error.message);
    }
    return;
  }
  
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error('Network error:', error);
}

Interactive Explorer

Our Interactive API Explorer allows you to test API endpoints directly in your browser without leaving the documentation. You can:

Test any endpoint with your API key
See real-time request and response data
Generate code examples in multiple languages (cURL, JavaScript, Python)
Copy request URLs and responses for use in your applications
Experiment with different parameters and see results instantly

Try the Interactive Explorer

Open the full-featured Interactive Explorer in a dedicated page for the best experience.

Open Interactive Explorer Or visit /explorer