---
title: "Get API public v1 live risk overview"
method: GET
path: "/api/public/v1/live/risk/overview"
---

# Get API public v1 live risk overview

`GET /api/public/v1/live/risk/overview`

## Response `200`

OK

- RiskOverviewBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `availability` RiskAvailability, required
    - `historicalClearinghouse` boolean, required
    - `liquidations` boolean, required
    - `liveCandles` boolean, required
    - `markPrices` boolean, required
    - `userActions` boolean, required
  - `avgLeverage` number, double
  - `concentrationTop10` number, double, required
  - `freshness` RiskFreshness, required
    - `historicalClearinghouse` string
    - `liquidations` string
    - `liveCandles` string
    - `livePositions` string
    - `longShort` string
    - `markPrices` string
  - `generatedAt` string, required
  - `history` RiskOverviewHistory, required
    - `avgLeverage` TimestampLeverage[], nullable, required
      - `long` number, double
      - `short` number, double
      - `timestamp` integer, required
    - `liquidations` GetLiquidationSummaryTimelineRow[], nullable, required
      - `bucketStart` integer, required
      - `count` integer, required
      - `totalClosedPnl` unknown, required
      - `totalNotional` unknown, required
      - `totalPenaltyFees` unknown, required
    - `netBias` TimestampValue[], nullable, required
      - `timestamp` integer, required
      - `value` number, double, required
    - `oi` TimestampValue[], nullable, required
      - `timestamp` integer, required
      - `value` number, double, required
  - `liquidationSummary7d` LiquidationSummaryBody, required
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `availability` RiskAvailability, required
      - `historicalClearinghouse` boolean, required
      - `liquidations` boolean, required
      - `liveCandles` boolean, required
      - `markPrices` boolean, required
      - `userActions` boolean, required
    - `avgClosedPnl` number, double, required
    - `avgPenaltyFee` number, double, required
    - `bucketSizeMs` integer, required
    - `byCohort` GetLiquidationSummaryByCohortRow[], nullable — Cohort (pnl_tier) split of the same window, sorted by totalNotional desc; wallets with no cohort classification aggregate under tier 'unclassified'. Only populated on GET /live/risk/liquidations/summary — omitted from the other consumers of this shape (risk overview, coin risk snapshot/history) to keep those hot paths from running an extra query.
      - `count` integer, required
      - `tier` string, required
      - `totalClosedPnl` unknown, required
      - `totalNotional` unknown, required
      - `wallets` integer, required
    - `byCoin` GetLiquidationSummaryByCoinRow[], nullable, required
      - `coin` string, required
      - `count` integer, required
      - `totalClosedPnl` unknown, required
      - `totalNotional` unknown, required
      - `totalPenaltyFees` unknown, required
    - `coin` string
    - `count` integer, required
    - `freshness` RiskFreshness, required
      - `historicalClearinghouse` string
      - `liquidations` string
      - `liveCandles` string
      - `livePositions` string
      - `longShort` string
      - `markPrices` string
    - `generatedAt` string, required
    - `longEvents` integer, required — Count of LONG liquidation events in the window (longEvents+shortEvents=count).
    - `longNotional` number, double, required — Notional of liquidated LONG positions in the window (side split of totalNotional; longNotional+shortNotional=totalNotional).
    - `shortEvents` integer, required — Count of SHORT liquidation events in the window.
    - `shortNotional` number, double, required — Notional of liquidated SHORT positions in the window (side split of totalNotional).
    - `since` string, required
    - `timeline` GetLiquidationSummaryTimelineRow[], nullable, required
      - `bucketStart` integer, required
      - `count` integer, required
      - `totalClosedPnl` unknown, required
      - `totalNotional` unknown, required
      - `totalPenaltyFees` unknown, required
    - `totalClosedPnl` number, double, required
    - `totalNotional` number, double, required
    - `totalPenaltyFees` number, double, required
    - `wallets` integer, required
  - `longPositions` integer, required
  - `longShort` GlobalLongShortBody, required
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `accountRatio` number, double, required
    - `avgLongLeverage` number, double
    - `avgLongSize` number, double, required
    - `avgShortLeverage` number, double
    - `avgShortSize` number, double, required
    - `bySymbol` CoinLongShortBody[], nullable, required
      - `$schema` string, uri — A URL to the JSON Schema for this object.
      - `avgLongLeverage` number, double
      - `avgLongSize` number, double, required
      - `avgShortLeverage` number, double
      - `avgShortSize` number, double, required
      - `coin` string, required
      - `concentrationTop5` number, double, required
      - `longAccounts` integer, required
      - `longUnrealizedPnl` number, double, required
      - `longVolume` number, double, required
      - `maxLeverage` number, double
      - `netBias` number, double, required
      - `ratio` number, double, required
      - `sampleSize` integer, required
      - `shortAccounts` integer, required
      - `shortUnrealizedPnl` number, double, required
      - `shortVolume` number, double, required
      - `timestamp` integer, required
      - `topLongs` LSTopPosition[], nullable, required
        - `address` string, required
        - `notional` number, double, required
        - `pnl` number, double, required
        - `size` number, double, required
      - `topShorts` LSTopPosition[], nullable, required
        - `address` string, required
        - `notional` number, double, required
        - `pnl` number, double, required
        - `size` number, double, required
      - `totalUnrealizedPnl` number, double, required
      - `volumeRatio` number, double, required
    - `concentrationTop5` number, double, required
    - `longUnrealizedPnl` number, double, required
    - `maxLeverage` number, double
    - `netBias` number, double, required
    - `sampleSize` integer, required
    - `shortUnrealizedPnl` number, double, required
    - `timestamp` integer, required
    - `totalLongAccounts` integer, required
    - `totalLongVolume` number, double, required
    - `totalShortAccounts` integer, required
    - `totalShortVolume` number, double, required
    - `totalUnrealizedPnl` number, double, required
    - `tradersTracked` integer, required
    - `volumeRatio` number, double, required
  - `nearLiquidationNotional` number, double, required
  - `netBias` number, double, required
  - `shortPositions` integer, required
  - `topCrowdedCoins` RiskOverviewCoin[], nullable, required
    - `avgLeverage` number, double
    - `avgLiquidationDistancePct` number, double
    - `coin` string, required
    - `concentrationTop5` number, double, required
    - `liquidationClosedPnl7d` number, double, required
    - `liquidationCount7d` integer, required
    - `liquidationPenaltyFees7d` number, double, required
    - `longPositions` integer, required
    - `nearLiquidationNotional` number, double, required
    - `netBias` number, double, required
    - `shortPositions` integer, required
    - `totalOI` number, double, required
    - `totalUnrealizedPnl` number, double, required
    - `uniqueWallets` integer, required
  - `totalOI` number, double, required
  - `totalUnrealizedPnl` number, double, required
  - `uniqueWallets` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) · [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coinversa/coinversa-api/revisions/77c03c427063/schema)