---
title: "Get Quant Whales History"
method: GET
path: "/api/v1/quant/whales/history"
tags: ["Quant"]
---

# Get Quant Whales History

`GET /api/v1/quant/whales/history`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/quant/whales/history`
- Auth: API key in header `X-API-Key`

Historic whale-activity movement — daily long/short notional (Pro Plus).

`live_only=true` returns observed points only (`meta.first_live_date` is
the first observed UTC day in the store, reported either way).

A daily time-series of aggregate whale positioning: per UTC day the total
`long_usd` / `short_usd` / `net_usd` / `gross_usd` across the ≥$100k account
book, plus the day's top coins by net.

Full-universe collection is recent, so the early part of the series is
**modeled** (each point carries `source` = `seed` | `live` and `estimated`):
a seeded baseline anchored to the first live reading that is replaced by
observed snapshots as they accrue. `meta.seeded_count` / `live_count` report
the split so you can trust-but-verify.

Full-universe aggregate history (not coin-scopable) — Pro Plus.

## Query parameters

- `days` integer: Trailing window length in days
- `live_only` boolean: Drop the modeled (source=seed) points; meta.first_live_date says where observed history starts

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)