TradePortfolio

OI Trends (DEX)

Dev

GET /hip3-analytics/oi-trends/dex


HIP-3 OI trends for one specific builder DEX — aggregate daily open interest series plus per-symbol breakdown for up to the top N symbols. Use it to understand how positioning on a particular DEX has evolved and which symbols are driving OI growth.

Authentication

Requires Dev tier or higher. Free tier does not have access (returns 403).

Parameters

Query parameters

NameTypeRequiredDescription
dex_namestringHIP-3 DEX identifier, e.g. hyperliquid_dex.
periodstring1w, 1m, or all. Defaults to all.
top_nintegerNumber of top symbols to include. Defaults to 10, max 15.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip3-analytics/oi-trends/dex?dex_name=hyperliquid_dex&period=1m"

Example response

json
{
  "success": true,
  "period": "1m",
  "dex_name": "hyperliquid_dex",
  "aggregate": [
    { "day": "2026-05-01", "oi_usd": 98000000 },
    { "day": "2026-05-02", "oi_usd": 104000000 },
    { "day": "2026-05-03", "oi_usd": 109000000 }
  ],
  "symbols": ["BTC", "ETH", "SOL"],
  "by_symbol": {
    "BTC": [
      { "day": "2026-05-01", "oi_usd": 42000000 },
      { "day": "2026-05-02", "oi_usd": 45000000 }
    ],
    "ETH": [
      { "day": "2026-05-01", "oi_usd": 28000000 },
      { "day": "2026-05-02", "oi_usd": 30000000 }
    ]
  }
}

Errors

  • 400 Missing required parameter dex_name.

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

Related