TradePortfolio
DocsDashboard
Docs

HIP-4 Analytics API Reference

Dev

GET /hip4-analytics/dashboard

Combined HIP-4 prediction market dashboard payload — volume, fees, trade counts, settlement series, and timeseries for the requested range, cached in Redis for fast retrieval. Use it as the primary data source for a HIP-4 analytics overview page without needing to make multiple calls.

Authentication

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

Parameters

Query parameters

NameTypeRequiredDescription
rangestring–4h, 1d, 7d, 30d, or all. Defaults to 1d. Legacy period remains supported as a compatibility alias.
venuestring–Restrict every metric and breakdown to one stored HIP-4 venue: out for Outcome.xyz or skew for Skew Markets. Omit for all deployers.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip4-analytics/dashboard?range=1d&venue=skew"

Example response

json
{
  "success": true,
  "range": "1d",
  "period": "1d",
  "venue": "skew",
  "computed_through_ms": 1788221100000,
  "summary": {
    "volume": 82000000,
    "fill_count": 50200,
    "orderbook_fill_count": 49600,
    "trade_count": 24800,
    "protocol_trade_count": 36200,
    "unique_traders": 2840,
    "total_fees": 41000
  },
  "timeseries": [
    { "date": "2026-09-01T00:00:00", "volume": 82000000, "trade_count": 24800 }
  ],
  "settlement_total": {
    "volume": 1800000,
    "fill_count": 920,
    "trade_count": 0,
    "unique_traders": 710,
    "total_fees": 0
  },
  "settlement_timeseries": []
}

Errors

  • 400 — Invalid venue value.

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

Related