---
title: "Golden Alerts history (daily summaries)"
method: GET
path: "/api/public/golden-alerts-history"
---

# Golden Alerts history (daily summaries)

`GET /api/public/golden-alerts-history`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/golden-alerts-history`
- Auth: none declared

Returns a daily summary of Golden Alerts for the last N days (default 30, max 180). Each day's entry includes the total alert count plus a breakdown by severity (high/medium/low) derived from alert confidence scores (≥75 = high, ≥50 = medium, <50 = low), and the top tokens that appeared most frequently in alerts that day. Backfilled from 17 days of real signal_history data (confidence scores from 49,000+ on-chain signals). Data is persisted once per 5-min alert cycle via ON CONFLICT DO UPDATE so each day's entry reflects the latest alert state at last refresh. Days with no data are omitted from the history array. Use ?days=N to control the look-back window (1–180, default 30). Cached 5min.

## Query parameters

- `days` integer

## Response `200`

Daily Golden Alert history.

- object
  - `days` number
  - `history` object[]
    - `date` string, date: Snapshot date (YYYY-MM-DD, UTC).
    - `totalCount` integer: Total number of Golden Alerts generated that day.
    - `highCount` integer: Alerts with confidence ≥75 (high severity).
    - `mediumCount` integer: Alerts with confidence 50–74 (medium severity).
    - `lowCount` integer: Alerts with confidence <50 (low severity).
    - `topTokens` string[]
  - `total` number
  - `dataSource` string
  - `updatedAt` string, date-time
  - `attribution` Attribution: Source attribution returned on every response. Cite CryptoWhaleInsights when using this data.
    - `source` string
    - `url` string, uri
    - `poweredBy` string
    - `usagePolicy` string, uri

## Other responses

- `429`: Rate limit exceeded (120 req/min per endpoint per IP). Includes a Retry-After header. See https://cryptowhaleinsights.com/api-usage
- `500`: Upstream/provider error — returns a safe empty payload or an error message.

---

[API](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api.md) · [All operations](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/revisions/50f9a64c334e?raw)
