Unusual Volume API

Find securities with outsized trading volume, grouped by upward and downward price movers.

GET /v1/unusual-volume

Quick Copy & Paste

https://api.earningsapi.com/v1/unusual-volume?apikey=YOUR_API_KEY

What can you build?

✓Surface high-activity tickers before deeper research.
✓Separate bullish and bearish unusual volume movers.
✓Rank watchlists by volumeChangePercent and session price change.

Parameters

Query

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

No additional parameters are required.

Response Example

{
  "date": "2026-06-05",
  "up": [
    {
      "symbol": "CMG",
      "name": "Chipotle Mexican Grill, Inc.",
      "price": 29.34,
      "changePercent": 4.12,
      "volume": 40675585,
      "volumeChangePercent": 12060
    },
    {
      "symbol": "BBCP",
      "name": "Concrete Pumping Holdings, Inc. ",
      "price": 10.43,
      "changePercent": 30.7,
      "volume": 4415422,
      "volumeChangePercent": 2769
    }
  ],
  "down": [
    {
      "symbol": "DRAM",
      "name": "Roundhill ETF Trust Roundhill Memory ETF",
      "price": 55.79,
      "changePercent": -15.08,
      "volume": 76360189,
      "volumeChangePercent": 61273
    },
    {
      "symbol": "IGV",
      "name": "iShares Expanded Tech-Software Sector ETF",
      "price": 95.85,
      "changePercent": -4.21,
      "volume": 19484870,
      "volumeChangePercent": 18911
    }
  ]
}

Top-Level Fields

Field	Type	Description
`date`	string	Data date in YYYY-MM-DD format
`up`	array	Securities with positive price moves and unusually high volume
`down`	array	Securities with negative price moves and unusually high volume

Mover Object Fields

Both up and down contain objects with the same shape.

Field	Type	Description
`symbol`	string	Ticker symbol
`name`	string	Company, ETF, or security name
`price`	number	Latest price returned by the API
`changePercent`	number	Price change percentage for the session
`volume`	number	Trading volume
`volumeChangePercent`	number	Volume change percentage returned by the API

cURL Example

curl "https://api.earningsapi.com/v1/unusual-volume?apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 100 requests / day and 1,000 requests / month
Daily and monthly reset windows use New York time
429 returned when either limit is exceeded

← Back to Docs