Distribution

Dev

GET /markets/distribution

Symbol distribution by OI or volume — returns each symbol's total value and 24h change, sorted by value. Designed to drive pie charts or treemaps showing market share. Use it to visualize where OI or volume is concentrated and how dominance is shifting between majors and altcoins.

Authentication

Requires Dev tier or higher.

Parameters

Query parameters

Name	Type	Required	Description
`metric`	string	✓	oi or volume.
`min_value`	float	–	Minimum threshold. Defaults to 1M.
`exchanges`	string	–	Comma-separated exchange filter.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/markets/distribution?metric=oi"

Example response

json

{
  "metric": "oi",
  "timestamp": "2026-06-08 06:00:00",
  "exchanges": null,
  "data": [
    {
      "symbol": "BTC",
      "value": 38400000000,
      "change_24h_pct": 2.4
    },
    {
      "symbol": "ETH",
      "value": 14200000000,
      "change_24h_pct": -1.2
    },
    {
      "symbol": "SOL",
      "value": 4800000000,
      "change_24h_pct": 8.7
    }
  ]
}

Errors

400 — Missing required parameter `metric`, or invalid value.

For authentication errors (401) and rate limit responses (429), see Errors.