Getting Started

Start querying financial data in minutes. Get an API key, make your first request, and integrate with your application or AI agent.

Authentication

All API requests require an API key passed via the X-API-Key header.

Example Request

curl -X GET "https://api.metricbay.ai/v1/companies/AAPL" \
  -H "X-API-Key: your_api_key"

https://api.metricbay.ai/v1

GET/companies/searchSearch companies by ticker or name

GET/companies/{ticker}Get company details

GET/income-statementsIncome statements with margins

GET/balance-sheetsBalance sheets with all line items

GET/cash-flow-statementsCash flow with FCF

GET/financial-metrics40+ computed ratios and growth rates

GET/institutional/holdersTop institutional holders of a stock

GET/institutional/portfolioA filer's 13F portfolio snapshot

GET/institutional/position-changesQoQ position changes

GET/institutional/summaryOwnership summary for a ticker

GET/institutional/search-filersSearch institutional filers

GET/insider-transactionsForm 4 insider trades

GET/companies/{ticker}/insider-summaryInsider trading summary stats

GET/insider-clustersDetected insider trading clusters

GET/companies/{ticker}/insider-quarterlyQuarterly insider activity

GET/screening/fundamentalsScreen by financial metrics

GET/screening/insiderScreen by insider activity

GET/screening/institutionalScreen by institutional ownership

All list endpoints return paginated results with the following structure:

{
  "data": [...],
  "pagination": {
    "total": 150,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

Use limit and offset query parameters to paginate through results.