Market Caps API

Retrieve real-time market capitalization rankings and data. Returns top 100 companies.

GET /v1/marketcaps

Quick Copy & Paste

https://api.earningsapi.com/v1/marketcaps?apikey=YOUR_API_KEY

Parameters

Query

Parameter	Type	Required	Description
`apikey`	string	Yes	Your API key

Response Example

[
  {
    "rank": 1,
    "symbol": "NVDA",
    "name": "NVIDIA",
    "marketCap": 4327101000000,
    "pctchange": -4.382,
    "prevRank": 1,
    "rankChange": 0
  },
  {
    "rank": 2,
    "symbol": "GOOG",
    "name": "Alphabet",
    "marketCap": 3887504720000,
    "pctchange": -2.476,
    "prevRank": 2,
    "rankChange": 0
  },
  {
    "rank": 3,
    "symbol": "AAPL",
    "name": "Apple",
    "marketCap": 3625978344200,
    "pctchange": -3.456,
    "prevRank": 3,
    "rankChange": 0
  },
  ...
]

Response Fields

The response is an array of companies ranked by market capitalization. Limited to top 100 companies.

Field	Type	Description
`rank`	number	Current rank by market cap
`symbol`	string	Stock ticker symbol
`name`	string	Company name
`marketCap`	number	Market capitalization in USD
`pctchange`	number	Percentage change (e.g. -4.382)
`prevRank`	number	Previous rank (one week ago)
`rankChange`	number	Change in rank (e.g. 0, 1, -1)

cURL Example

curl "https://api.earningsapi.com/v1/marketcaps?apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 1,000 requests / month
429 returned when limit is exceeded