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.meridianmarketflowapi.com/v1/health

Note: The health endpoint is public and does not require an API key. For other endpoints, include your API key as shown in the examples above.

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
sector	string	Optional	Filter by sector
industry	string	Optional	Filter by industry
limit	number	Optional	Max results (default: 20)
offset	number	Optional	Pagination offset

Example Request

https://api.meridianmarketflowapi.com/v1/companies/search?query=apple&exchange=Nasdaq&sector=Services&industry=Services-Computer+Programming+Services&limit=20&offset=0&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

Example Request

https://api.meridianmarketflowapi.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

Example Request

https://api.meridianmarketflowapi.com/v1/companies?exchange=Nasdaq&sector=Services&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 (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
limit	number	Optional	Max results (default: 10)

Example Request

https://api.meridianmarketflowapi.com/v1/fundamentals/AAPL/income-statement?period=annual&from_date=2020-01-01&to_date=2024-12-31&limit=10&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 (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
limit	number	Optional	Max results (default: 10)

Example Request

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

GET

/v1/fundamentals/{symbol}/ratios

Get financial ratios

Parameters

Name	Type	Required	Description
symbol	string	Required	Ticker symbol
period	string	Optional	Period type: annual or quarterly (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters by the period end date of financial statements.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters by the period end date of financial statements.
limit	number	Optional	Max results (default: 10)

Example Request

https://api.meridianmarketflowapi.com/v1/fundamentals/AAPL/ratios?period=annual&from_date=2020-01-01&to_date=2024-12-31&limit=10&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 (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
limit	number	Optional	Max results (default: 10)

Example Request

https://api.meridianmarketflowapi.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 (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters by the period end date of financial statements.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters by the period end date of financial statements.
limit	number	Optional	Max results (default: 10)

Example Request

https://api.meridianmarketflowapi.com/v1/fundamentals/AAPL/metrics?period=annual&from_date=2020-01-01&to_date=2024-12-31&limit=10&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

Example Request

https://api.meridianmarketflowapi.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
date	string	Optional	Specific date (YYYY-MM-DD). If not provided, returns most recent
limit	number	Optional	Number of days to return (default: 1, max: 100)

Example Request

https://api.meridianmarketflowapi.com/v1/prices/eod/AAPL?date=2024-01-15&limit=1&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)

Example Request

https://api.meridianmarketflowapi.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

Example Request

https://api.meridianmarketflowapi.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 on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
to_date	string	Optional	End date filter on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
limit	number	Optional	Max results (default: 20)
offset	number	Optional	Pagination offset

Example Request

https://api.meridianmarketflowapi.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 (up to 10 digits)
from_date	string	Optional	Start date filter on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
to_date	string	Optional	End date filter on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
limit	number	Optional	Max results (default: 20)
offset	number	Optional	Pagination offset

Example Request

https://api.meridianmarketflowapi.com/v1/holdings/institutions/947996?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)
symbols	string	Optional	Comma-separated list of ticker symbols

Example Request

https://api.meridianmarketflowapi.com/v1/bulk/companies?format=csv&exchange=Nasdaq&sector=Services&part=1&symbols=AAPL%2CMSFT&api_key=YOUR_API_KEY

GET

/v1/bulk/fundamentals/{statement_type}

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

Parameters

Name	Type	Required	Description
statement_type	string	Required	Statement type: income-statement, balance-sheet, or cash-flow
format	string	Optional	Response format: csv or json (default: csv)
part	number	Required	Part number to retrieve (1-based, required)
period	string	Optional	Period type: annual or quarterly (default: annual)
from_date	string	Optional	Start date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
to_date	string	Optional	End date filter on period_end_date (YYYY-MM-DD). Filters financial statements by their period end date.
symbols	string	Optional	Comma-separated list of ticker symbols

Example Request

https://api.meridianmarketflowapi.com/v1/bulk/fundamentals/income-statement?format=csv&part=1&period=annual&from_date=2024-01-01&to_date=2024-12-31&symbols=AAPL%2CMSFT&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)
from_date	string	Optional	Start date filter on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
to_date	string	Optional	End date filter on filing_date (YYYY-MM-DD). Filters holdings by the SEC filing date.
symbols	string	Optional	Comma-separated list of ticker symbols

Example Request

https://api.meridianmarketflowapi.com/v1/bulk/holdings/institutional?format=csv&part=1&from_date=2024-01-01&to_date=2024-12-31&symbols=AAPL%2CMSFT&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)
from_date	string	Optional	Start date filter (YYYY-MM-DD)
to_date	string	Optional	End date filter (YYYY-MM-DD)
symbols	string	Optional	Comma-separated list of ticker symbols

Example Request

https://api.meridianmarketflowapi.com/v1/bulk/insiders/transactions?format=csv&part=1&from_date=2024-01-01&to_date=2024-12-31&symbols=AAPL%2CMSFT&api_key=YOUR_API_KEY

Health Check

Check API health status.

GET

/v1/health

Check API health status

Example Request

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

Rate Limits

Plan Comparison

Feature	Basic (Free)	Premium
Requests/Day	250	~1.44M (theoretical)
Monthly Bandwidth	500 MB	50 GB

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.meridianmarketflowapi.com/v1/companies/AAPL?api_key=YOUR_API_KEY'
);
const company = await response.json();

// Fetch income statement
const incomeResponse = await fetch(
  'https://api.meridianmarketflowapi.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.meridianmarketflowapi.com/v1/companies/AAPL',
    params={'api_key': 'YOUR_API_KEY'}
)
company = response.json()

# Fetch income statement
income_response = requests.get(
    'https://api.meridianmarketflowapi.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.meridianmarketflowapi.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