---
title: "Get canonical platform metrics — tracked wallets, chains, win rate, BTC benchmark"
method: GET
path: "/api/public/platform-stats"
---

# Get canonical platform metrics — tracked wallets, chains, win rate, BTC benchmark

`GET /api/public/platform-stats`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/platform-stats`
- Auth: none declared

Canonical platform metrics: tracked wallets, chains, tokens, tools, languages, supported chain list, plus a safe aggregate performance subset (win rate, average return, BTC benchmark). Cached ~60s. Response includes `meta.updatedAt` (ISO timestamp of when the response was generated).

## Response `200`

Platform statistics object.

- object
  - `chains` number
  - `trackedWallets` number
  - `tokensTracked` number
  - `freeTools` number
  - `languages` number
  - `dataSources` number
  - `chainList` string[]
  - `performance` object: Aggregate signal performance metrics.
    - `winRate` number: Percentage of resolved signals that were profitable (0–100).
    - `avgReturn` number: Average return across all resolved signals (%).
    - `avgBtcBenchmark` number, nullable: Average BTC price change over the same holding windows as the resolved signals (%). Null when not enough data.
    - `totalResolved` number: Total number of signals with a resolved outcome.
    - `totalSignalCount` number: All-time signal count (including unresolved).
    - `wins` number: Number of winning resolved signals.
    - `losses` number: Number of losing resolved signals.
    - `dataStartedAt` string, date-time, nullable: ISO timestamp of the oldest resolved signal.
  - `live` object
  - `updatedAt` string, date-time
  - `meta` object: Response freshness metadata.
    - `updatedAt` string, date-time: ISO timestamp of when the response was generated.
  - `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)