---
title: "Daily report snapshot"
method: GET
path: "/api/v1/reports/daily"
tags: ["Reports"]
---

# Daily report snapshot

`GET /api/v1/reports/daily`

Returns a dated daily whale-activity report snapshot with source_range, snapshot.status, completeness, and reconciliation metadata. Report whale volume is local whale-alert activity volume, not provider lifetime trader volume.

## Query parameters

- `date` string, required

## Response `200`

Daily report snapshot

- object
  - `object` 'report_snapshot', required
  - `data` ReportSnapshot, required
    - `kind` 'daily' | 'weekly' | 'monthly', required
    - `generated_at` string, date-time, required
    - `source_range` ReportSourceRange, required
      - `start_date` string, date, required
      - `end_date` string, date, required
      - `timezone` 'UTC', required
    - `snapshot` SnapshotState, required
      - `status` 'final' | 'rolling', required
      - `generated_at` string, date-time, required
      - `mutable_until` string, date, nullable
    - `completeness` SnapshotCompleteness, required
      - `status` 'complete' | 'partial' | 'empty', required
      - `reason` string, required
      - `expected_days` integer, required
      - `covered_days_with_whale_activity` integer, required
    - `reconciliation` ReportReconciliation, required
      - `volume_kind` 'local_whale_activity_volume', required
      - `whale_volume_source` 'whale_alerts.usdc_notional_num', required
      - `notes` string, required
    - `report` ReportPayload, required
      - `total_whale_trades` integer, nullable
      - `total_whale_volume` number, nullable
      - `biggest_trade_size` number, nullable
      - `active_traders` integer, nullable
      - `top_whale_trades` object[], nullable
        - `outcome` string, nullable — Provider outcome label for the traded side.
        - `side` string, nullable — Trade direction (BUY or SELL), not the outcome side.
        - `title` string, nullable — Market title.
        - `size` number, nullable — Trade size in USD.
        - `price` number, nullable — Trade price in provider [0, 1] units.
        - `token_id` string, nullable — The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. Kalshi markets, unsynced markets).
        - `id` integer, nullable — Whale trade id.
        - `trade_time` string, date-time, nullable — Trade timestamp (UTC).
        - `market_category` string, nullable — Provider market category.
        - `platform` string, nullable — Venue: polymarket or kalshi.
        - `name` string, nullable — Trader display name, when known.
        - `pseudonym` string, nullable — Trader pseudonym, when no display name is known.
        - `trader_grade` string, nullable — Trader grade (S-F) at snapshot time.
      - `categories` object[], nullable
      - `grade_distribution` object[], nullable
  - `meta` ResponseMeta, required
    - `request_id` string, required — Unique request ID (req_ prefix).
    - `cached` boolean, required
    - `cache_age_s` integer, nullable — Cache age in seconds, null if not cached.

## Other responses

- `400` — Invalid request parameter
- `401` — Missing or invalid API key
- `402` — Active Insider subscription required
- `403` — Account access denied
- `408` — Request exceeded the server's 30-second transport timeout. The timeout response has an empty body because it is generated before handler-level JSON error shaping.
- `423` — Account is locked
- `429` — Rate limit exceeded (100 req/min; batch endpoints also reserve 100 batch item units/min before execution)
- `500` — Unexpected server error
- `503` — Redis-backed authenticated rate limiter unavailable; retry after the per-process outage cooldown

## Changes

- **2026-07-01** `1777a41bfb53` — 13 info
  - added the optional property `data/report/top_whale_trades/items/id` to the response with the `200` status
  - added the optional property `data/report/top_whale_trades/items/market_category` to the response with the `200` status
  - added the optional property `data/report/top_whale_trades/items/name` to the response with the `200` status
  - added the optional property `data/report/top_whale_trades/items/outcome` to the response with the `200` status
  - …9 more
- **2026-06-01** `422bd4dc1611` — 72 warning, 1 info
  - added the new `account_locked` enum value to the `error/code` response property for the response status `400`
  - added the new `account_locked` enum value to the `error/code` response property for the response status `401`
  - added the new `account_locked` enum value to the `error/code` response property for the response status `402`
  - added the new `account_locked` enum value to the `error/code` response property for the response status `403`
  - …69 more
- **2026-05-08** `80e8658e5acf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/0xinsider/apis/0xinsider-api/changes/api/v1/reports/daily/get.md)

---

[API](https://skmtc.dev/0xinsider/apis/0xinsider-api.md) · [All operations](https://skmtc.dev/0xinsider/apis/0xinsider-api/llms.txt) · [OpenAPI document](https://skmtc.dev/0xinsider/apis/0xinsider-api/revisions/137fa0fd3297?raw)