MMTMMT Docs
REST APIOpenAPI Reference

Get liquidation heatmap

Returns liquidation heatmap data in flat format. Available only for hyperliquid and hyperliquid-xyz. Single exchange only (aggregated exchanges are not supported). Cost multiplier: 5x. Max 5,000 data points per request.

GET
/api/v1/liquidation_heatmap

Returns liquidation heatmap data in flat format. Available only for hyperliquid and hyperliquid-xyz. Single exchange only (aggregated exchanges are not supported). Cost multiplier: 5x. Max 5,000 data points per request.

Authorization

ApiKeyAuth
X-API-Key<token>

API key for authentication. Obtain from the MMT dashboard. Keep secret and use only from your backend; never expose in browser/mobile clients.

In: header

Query Parameters

exchange*string

Exchange identifier (e.g. binancef, bybitf, okx). Some endpoints support aggregation via colon-separated values (e.g. binancef:bybitf).

symbol*string

Trading pair in base/quote format.

tf*string

Timeframe string for REST requests. Examples: 1m, 5m, 1h, 1d, 1W, 1M. Allowed range: minimum 1m, maximum 1M (1 month).

from*integer

Start of time range as a Unix timestamp (seconds).

Formatint64
to*integer

End of time range as a Unix timestamp (seconds). Must be greater than from.

Formatint64
format?string

Response format. Defaults to json. Set to cbor for binary CBOR encoding.

Value in"json" | "cbor"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://eu-central-1.mmt.gg/api/v1/liquidation_heatmap?exchange=binancef&symbol=btc%2Fusd&tf=1m&from=1738368000&to=1738382400"
{
  "data": [
    {
      "t": 0,
      "pg": 0,
      "s": [
        0
      ],
      "lp": 0,
      "si": 0,
      "minp": 0,
      "maxp": 0,
      "mins": 0,
      "maxs": 0
    }
  ],
  "exchange": "string",
  "symbol": "string",
  "tf": "string",
  "from": 0,
  "to": 0,
  "points": 0
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid request parameters",
    "details": {}
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid request parameters",
    "details": {}
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid request parameters",
    "details": {}
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid request parameters",
    "details": {}
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid request parameters",
    "details": {}
  }
}

Get heatmap (standard definition) GET

Returns orderbook heatmap data at standard definition. Supports aggregated exchanges (requires tier permission). Cost multiplier: 5x. Max 5,000 data points per request.

Get available markets GET

Returns all available exchanges, symbols, streams, bucket groups, and your tier's access information.