---
title: "Earnings move track record: answers \"does the options market systematically"
method: GET
path: "/v1/earnings-move-history"
---

# Earnings move track record: answers "does the options market systematically

`GET /v1/earnings-move-history`

## Request

- Base URL: `https://api.alphanume.com`
- URL: `https://api.alphanume.com/v1/earnings-move-history`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Earnings move track record: answers "does the options market systematically
over- or under-price this name's earnings moves?" One row per earnings event per
ticker: the pre-earnings ATM straddle price and implied move (% and $), ATM IV,
the realized post-earnings return and absolute move, the over/under-pricing gap
and move ratio, an `overpriced` flag, EPS estimate vs actual, plus running
per-ticker history stats (events to date, hit rate of straddle overpricing,
average implied vs realized move to date).

Use it before an earnings trade: query `ticker` to see whether selling or buying
the earnings straddle has historically paid on that name, or screen a `date` to
review how yesterday's reporters resolved. `date` is the earnings date.

Requires an Alphanume Pro API key. A 403 PRO_SUBSCRIPTION_REQUIRED or
DATE_RANGE_RESTRICTED error means the key's plan does not cover the request --
it does not mean the data is missing.

## Query parameters

- `ticker` string
- `date` string
- `date_gte` string
- `date_lte` string
- `date_gt` string
- `date_lt` string

## Response `200`

Matching rows.

- Envelope
  - `count` integer, required
  - `data` object[], required

## Other responses

- `400`: Invalid or conflicting query parameters.
- `401`: Missing or unrecognized API key.
- `403`: PRO_SUBSCRIPTION_REQUIRED: the key's plan does not include API access; every endpoint requires an active Pro subscription. DATE_RANGE_RESTRICTED: a legacy free-tier key asked for dates outside its window. In both cases the data is not missing.
- `429`: Rate limit exceeded (600/min); the body carries retry_after_seconds.

---

[API](https://skmtc.dev/alphanume/apis/alphanume-api.md) · [All operations](https://skmtc.dev/alphanume/apis/alphanume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphanume/apis/alphanume-api/revisions/2cb83f10bba4?raw)