---
title: "Dataset coverage stats"
method: GET
path: "/options-flow/stats"
tags: ["Meta"]
---

# Dataset coverage stats

`GET /options-flow/stats`

## Request

- Base URL: `https://optionsbell.com/api/v1`
- URL: `https://optionsbell.com/api/v1/options-flow/stats`
- Auth: API key in header `X-API-Key`

Available date ranges, contract counts, symbol counts and sector
coverage. Lets clients and agents discover what is queryable before
they query it. `rescan_cadence_minutes` is the intraday refresh
interval of the current day (5).

## Response `200`

Coverage summary

- StatsResponse
  - `unusual_activity` object, required
    - `date_from` string, date, nullable
    - `date_to` string, date, nullable
    - `contracts` integer
    - `symbols` integer
  - `daily_flow` object, required
    - `date_from` string, date, nullable
    - `date_to` string, date, nullable
    - `trading_days` integer
    - `symbols` integer
  - `sectors` object, required
    - `distinct_sectors` integer
    - `classified_symbols` integer
  - `rescan_cadence_minutes` integer, required

## Other responses

- `401`: Missing or invalid API key: `MISSING_API_KEY`, `INVALID_API_KEY_FORMAT`, `INVALID_API_KEY`. No rate-limit headers.
- `403`: Key is valid but has no usable subscription: `NO_ACTIVE_SUBSCRIPTION` (no Personal plan on the key) or `SUBSCRIPTION_INACTIVE` (past due, paused, expired, or canceled past its period end). No rate-limit headers.
- `429`: Rate limit exceeded: `RATE_LIMIT_MINUTE` (60/min) or `RATE_LIMIT_DAY` (4,000/day). Carries both rate-limit header sets and `Retry-After` (seconds until the exhausted window opens again). Rejected requests count against the minute window, so back off instead of retrying immediately.
- `500`: Unexpected server error: `INTERNAL_ERROR`. The body and the X-Request-Id header carry the request id.
- `503`: Authentication backend unreachable: `AUTH_UNAVAILABLE`. Retry later. No rate-limit headers.

---

[API](https://skmtc.dev/optionsbell/apis/optionsbell-options-flow-api.md) · [All operations](https://skmtc.dev/optionsbell/apis/optionsbell-options-flow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optionsbell/apis/optionsbell-options-flow-api/revisions/42db9bcaa61f?raw)