TradePortfolio
DocsSymbol Distribution
Docs

Symbol Distribution

Dev

GET /markets/{symbol}/distribution

Per-exchange share of OI or volume for one symbol — how trading activity is distributed across venues. Returns one row per exchange with the symbol's value on that exchange and its percentage of the total. Use it to build a pie chart showing exchange dominance for a specific coin, or to spot concentration risk.

Authentication

Requires Dev tier or higher.

Parameters

Path parameters

NameTypeRequiredDescription
symbolstring✓Base symbol, e.g. BTC.

Query parameters

NameTypeRequiredDescription
metricstring✓volume or oi.

Example request

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

Example response

json
{
  "symbol": "BTC",
  "metric": "oi",
  "timestamp": "2026-06-08 06:00:00",
  "data": [
    {
      "exchange": "binance",
      "value": 7200000000,
      "share": 0.188
    },
    {
      "exchange": "bybit",
      "value": 3100000000,
      "share": 0.081
    },
    {
      "exchange": "okx",
      "value": 2800000000,
      "share": 0.073
    }
  ]
}

Errors

  • 400 — Missing required parameter `metric`.
  • 404 — Symbol not found.

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

Related