---
title: "Golden Alerts snapshot — latest market intelligence alerts (public, MCP-compatible)"
method: GET
path: "/api/public/golden-alerts-snapshot"
---

# Golden Alerts snapshot — latest market intelligence alerts (public, MCP-compatible)

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

## Request

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

Returns the latest snapshot of CryptoWhaleInsights Golden Alerts — up to 27 high-signal market alerts refreshed every 5 minutes by the platform's cron job. Each alert represents a confluence of whale on-chain activity, volume momentum, and Fear & Greed context. This endpoint reads directly from the in-process cache (no new AI query triggered per request). Pro-only fields (raw confidence score, internal factors, price targets, exit signals) are intentionally omitted; severity is mapped to low/medium/high for public consumption. Alert types: accumulation | fear_buy | smart_money_loading | volume_breakout | whale_convergence. Severity mapping: high (confidence ≥70%), medium (45–69%), low (<45%). Response: { alerts[], total, refreshedAt (ISO-8601 or null if cache empty), updatedAt }. Each alert: id, title, type, severity, tokens (string[]), chains (string[]), summary, aiInsight, analystId (string | null), createdAt. No authentication required. 120 requests/min rate limit.

## Response `200`

Latest Golden Alerts snapshot (no auth, cached, Pro fields stripped).

- object
  - `alerts` object[]: Golden Alerts sorted by severity (highest first), up to 27 entries.
    - `id` string: Unique alert identifier, e.g. 'ga-1719220800000-abc123'
    - `title` string: Human-readable alert title, e.g. 'Fear Buy Opportunity'
    - `type` string: Alert classification: accumulation | fear_buy | smart_money_loading | volume_breakout | whale_convergence
    - `severity` string: 'high' (confidence ≥70%) | 'medium' (45–69%) | 'low' (<45%)
    - `tokens` string[]: Token symbols involved, e.g. ['BTC', 'ETH']
    - `chains` string[]: Blockchain networks, e.g. ['bitcoin', 'ethereum']
    - `summary` string: Signal summary combining whale moves, volume, and Fear & Greed context
    - `aiInsight` string: One-sentence AI-generated actionable insight
    - `analystId` string, nullable: Attributed analyst slug: chain_hawk | whale_watch | alpha_scout | defi_pulse | quant_edge | rate_hawk | flow_tracer | unlock_guard | sentiment_edge | narrative_pulse | null
    - `createdAt` string, date-time: When this alert was generated
  - `total` number: Number of alerts in the snapshot
  - `refreshedAt` string, date-time, nullable: When the cron job last populated the cache; null if cache is empty
  - `updatedAt` string, date-time: Response generation timestamp
  - `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)