MMTMMT Docs
REST APIOpenAPI Reference

Get flat heatmap (high definition)

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

GET
/api/v1/flat_heatmap_hd

Returns flat orderbook heatmap data at high definition. Supports aggregated exchanges (requires tier permission). Cost multiplier: 10x. Max 4,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/flat_heatmap_hd?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 OHLCVT candles GET

Returns OHLCVT (Open, High, Low, Close, Volume, Trades) candle data for a single exchange and symbol. Does not support aggregated exchanges. Max 100,000 data points per request.

Get flat heatmap (standard definition) GET

Returns flat orderbook heatmap data at standard definition. Flat heatmaps use a fixed-size array instead of price/size pairs — more compact for dense data. Supports aggregated exchanges (requires tier permission). Cost multiplier: 5x. Max 5,000 data points per request.