## Documentation Index Fetch the complete documentation index at: https://coinmarketcap.com/llms.txt Use this file to discover all available pages before exploring further. # Latest Total Liquidations `GET /v5/derivatives/liquidations/quotes/latest` [Back to Derivatives endpoint index](https://coinmarketcap.com/api/documentation/pro-api-reference/derivatives.md) [Open this endpoint in interactive docs](https://coinmarketcap.com/api/documentation/pro-api-reference/derivatives#latest-total-liquidations) Returns aggregate perpetual and futures liquidation values across every exchange that CoinMarketCap tracks, summed over rolling 1-hour, 4-hour, and 24-hour windows. These are the global headline figures shown on the [CoinMarketCap liquidations chart](https://coinmarketcap.com/charts/liquidations/). Each window is reported three ways, and every value is denominated in the convert currency: - `long_liquidations_*` is the total value of long positions that were force-closed, meaning traders who were betting on a price increase had their positions liquidated through forced market sells. - `short_liquidations_*` is the total value of short positions that were force-closed, meaning traders who were betting on a price decrease had their positions liquidated through forced market buys. - `total_liquidations_*` is the combined value of the long and short liquidations in that same window. All three windows are rolling and end at the moment your request is made, rather than aligning to fixed calendar boundaries. This endpoint returns the global totals only. If you need the same figures broken down per exchange or per cryptocurrency, use [/v5/derivatives/liquidations/exchange/list/latest](https://coinmarketcap.com/api/documentation/pro-api-reference/derivatives#latest-liquidations-by-exchange) or [/v5/derivatives/liquidations/cryptocurrency/list/latest](https://coinmarketcap.com/api/documentation/pro-api-reference/derivatives#latest-liquidations-by-cryptocurrency) instead. **Cache / Update frequency:** Every 60 seconds. **Plan credit use:** 1 call credit per request, plus 1 credit per `convert` / `convert_id` option beyond the first. **CMC equivalent page:** [coinmarketcap.com/charts/liquidations/](https://coinmarketcap.com/charts/liquidations/) #### Code examples cURL: ```bash curl -G "https://pro-api.coinmarketcap.com/v5/derivatives/liquidations/quotes/latest" \ -H "X-CMC_PRO_API_KEY: $CMC_PRO_API_KEY" ``` JavaScript / TypeScript, with the official SDK [`@coinmarketcap/sdk`](https://www.npmjs.com/package/@coinmarketcap/sdk) (`npm install @coinmarketcap/sdk`): ```typescript import { CoinMarketCap } from "@coinmarketcap/sdk"; const cmc = new CoinMarketCap({ apiKey: process.env.CMC_PRO_API_KEY, }); const { data, error } = await cmc.api.derivatives.liquidationsQuotesLatest({}); if (error) throw error; console.log(data); ``` Python, with the official SDK [`coinmarketcap-sdk`](https://pypi.org/project/coinmarketcap-sdk/) (`pip install coinmarketcap-sdk`): ```python import os from coinmarketcap import CoinMarketCap cmc = CoinMarketCap(api_key=os.environ["CMC_PRO_API_KEY"]) result = cmc.derivatives.liquidations_quotes_latest() print(result) ``` Go, with the official SDK [`github.com/OpenCMC/coinmarketcap-api-go/v5`](https://pkg.go.dev/github.com/OpenCMC/coinmarketcap-api-go/v5) (`go get github.com/OpenCMC/coinmarketcap-api-go/v5`): ```go package main import ( "context" "encoding/json" "fmt" "log" "os" "github.com/OpenCMC/coinmarketcap-api-go/v5" ) func main() { cmc, err := coinmarketcap.New(coinmarketcap.WithAPIKey(os.Getenv("CMC_PRO_API_KEY"))) if err != nil { log.Fatal(err) } result, err := cmc.Derivatives.LiquidationsQuotesLatest(context.Background(), nil) if err != nil { log.Fatal(err) } out, _ := json.MarshalIndent(result, "", " ") fmt.Println(string(out)) } ``` #### API Summary ```yaml method: GET path: /v5/derivatives/liquidations/quotes/latest operationId: getV5DerivativesLiquidationsQuotesLatest parameters: - name: convert in: query required: false schema: type: string description: "Optionally calculate values in up to 120 fiat or cryptocurrency conversions at once by passing a comma-separated list of symbols. Example: `EUR,BTC`. Each conversion beyond the first costs 1 additional call credit and is returned as its own entry in `quotes[]`. Cannot be used with `convert_id`. Defaults to USD when both are omitted." - name: convert_id in: query required: false schema: type: string description: "Same as `convert`, but by CoinMarketCap currency ID instead of symbol. Example: `convert_id=2781`. Cannot be used with `convert`. Defaults to `2781` (USD) when both are omitted." responses: "200": description: Successful content: application/json: $ref: "#/components/schemas/Liquidations_Total_-_Response_Model" errors: - 400 - 401 - 403 - 429 - 500 ``` ## Components ```yaml components: schemas: Liquidations_Total_-_Response_Model: type: object required: - data properties: data: $ref: "#/components/schemas/Liquidations_Total_-_Results_object" status: $ref: "#/components/schemas/API_Status_Object" Liquidations_Total_-_Results_object: type: object description: Results of your query returned as an object. properties: quotes: type: array description: One entry per requested convert currency. Never a bare array at `data`. items: type: object properties: crypto_id: type: integer description: CoinMarketCap ID of the convert currency (e.g. `2781` for USD). Always present. symbol: type: string description: Symbol of the convert currency (e.g. `USD`). Always present. total_liquidations_1h: type: number description: Total notional liquidated in the rolling 1h window, in the convert currency. long_liquidations_1h: type: number description: Longs liquidated (forced sells) in the rolling 1h window. short_liquidations_1h: type: number description: Shorts liquidated (forced buys) in the rolling 1h window. total_liquidations_4h: type: number description: Total notional liquidated in the rolling 4h window. long_liquidations_4h: type: number description: Longs liquidated (forced sells) in the rolling 4h window. short_liquidations_4h: type: number description: Shorts liquidated (forced buys) in the rolling 4h window. total_liquidations_24h: type: number description: Total notional liquidated in the rolling 24h window. long_liquidations_24h: type: number description: Longs liquidated (forced sells) in the rolling 24h window. short_liquidations_24h: type: number description: Shorts liquidated (forced buys) in the rolling 24h window. last_updated: type: string format: date-time description: ISO 8601 timestamp of the last aggregation for this quote. API_Status_Object: type: object description: Standardized status object for API calls. required: - timestamp - error_code - error_message - elapsed - credit_count properties: timestamp: type: string format: yyyy-MM-dd'T'HH:mm:ss.SSSZ description: Current timestamp (ISO 8601) on the server. error_code: type: - integer - string description: An internal error code for the current error. If a unique platform error code is not available the HTTP status code is returned. `0` is returned if there is no error. Some endpoints return this code as a string, for example `"0"`. error_message: type: - string - "null" description: An error message to go along with the error code. elapsed: type: integer description: Number of milliseconds taken to generate this response. credit_count: type: integer description: Number of API call credits that were used for this call. notice: type: - string - "null" description: Optional notice about API key information. total_count: type: integer description: Total number of results available for this request. Only returned by some list endpoints. ```