---
title: "Get aggregated market context for a date in one call — Fear & Greed, whale summary, sentiment, stablecoin flows, funding rates, golden alerts, analyst summaries (8 sources parallel)"
method: GET
path: "/api/public/market-context"
---

# Get aggregated market context for a date in one call — Fear & Greed, whale summary, sentiment, stablecoin flows, funding rates, golden alerts, analyst summaries (8 sources parallel)

`GET /api/public/market-context`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/market-context`
- Auth: none declared

Single-call aggregated market snapshot for a given date. Queries 8 data sources in parallel — Fear & Greed, whale daily summary, social sentiment (BTC/ETH/SOL), stablecoin flows, BTC funding rates, Golden Alerts daily count, analyst daily summaries (shortSummary only), and top arbitrage opportunities. No authentication required. Use ?date=YYYY-MM-DD (default = today; max 730 days back / 2 years). For dates older than 365 days where daily snapshots have been purged, the endpoint automatically falls back to the permanent monthly archive tables, returning monthly averages instead of daily values. metadata.resolution indicates 'daily' (exact day data) or 'monthly' (monthly averages from archive). metadata.dataCompleteness is the percentage of the 8 sources that have data for the requested date (0-100%). Today is cached 5 minutes; historical dates cached 1 hour. 30 req/min.

## Query parameters

- `date` string, date

## Response `200`

Aggregated market context snapshot for the requested date.

- object
  - `date` string, date: Requested date (YYYY-MM-DD)
  - `fearGreed` object, nullable: Fear & Greed index for the date (daily score or monthly avg when resolution=monthly).
    - `score` number
    - `classification` string
  - `whaleSummary` object, nullable: Aggregated whale movement counts for the date.
    - `totalMoves` number
    - `inflowCount` number
    - `outflowCount` number
    - `totalUsdValue` number
  - `sentiment` object[]: Social sentiment for BTC, ETH, SOL (daily score or monthly avg when resolution=monthly).
    - `symbol` string
    - `score` number, nullable
    - `sentiment` string, nullable
  - `stablecoin` object, nullable: Stablecoin flow snapshot for the date.
    - `totalFlow24h` number
    - `totalNow` number
    - `signal` string, nullable
  - `fundingRates` object: BTC perpetual funding rate summary for the date (daily or monthly avg).
    - `symbol` string
    - `avg` number, nullable
    - `sentiment` string, nullable
    - `byExchange` object
  - `goldenAlerts` object, nullable: Golden Alerts daily summary for the date.
    - `totalCount` number
    - `highCount` number
    - `mediumCount` number
    - `lowCount` number
    - `topTokens` string[]
  - `analystSummaries` object[]
    - `analystId` string
    - `shortSummary` string
    - `signalCount` number
    - `confluenceScore` number, nullable
    - `btcTrend` string, nullable
  - `arbitrage` object[]
    - `symbol` string
    - `spreadPct` number
    - `buyExchange` string
    - `sellExchange` string
    - `usdVolume` number
  - `metadata` object
    - `date` string
    - `isToday` boolean
    - `resolution` 'daily' | 'monthly': 'daily' = exact day data from snapshots; 'monthly' = monthly averages from permanent archive (triggered for dates >180 days old with <50% daily completeness)
    - `dataCompleteness` number: Percentage of 8 sources with data for this date (0-100)
    - `sourcesAvailable` number
    - `sourcesTotal` number
    - `generatedAt` string, date-time
  - `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)