TradePortfolio
DocsOutcome Detail
Docs

Outcome Detail

Dev

GET /hip4-analytics/outcome/{outcome_id}

Scoped dashboard bundle for one HIP-4 outcome market — volume, fees, trade counts, timeseries, and settlement data specific to that outcome. Use it to build a per-outcome analytics page or deep-dive into one prediction market's trading history.

Authentication

Requires Dev tier or higher.

Parameters

Path parameters

NameTypeRequiredDescription
outcome_idinteger✓Outcome market ID. Must be a non-negative integer.

Query parameters

NameTypeRequiredDescription
rangestring–4h, 1d, 7d, 30d, or all. Defaults to 1d. Legacy period remains supported as a compatibility alias.

Example request

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

Example response

json
{
  "success": true,
  "outcome_id": 1,
  "range": "7d",
  "period": "1w",
  "computed_through_ms": 1788221100000,
  "summary": {
    "volume": 8400000,
    "fill_count": 5840,
    "orderbook_fill_count": 5680,
    "trade_count": 2840,
    "protocol_trade_count": 4120,
    "unique_traders": 420,
    "total_fees": 4200
  },
  "timeseries": [
    { "date": "2026-08-31", "volume": 1200000, "trade_count": 410 },
    { "date": "2026-09-01", "volume": 1400000, "trade_count": 480 }
  ],
  "settlement": {
    "volume": 620000,
    "fill_count": 310,
    "trade_count": 0,
    "unique_traders": 240,
    "total_fees": 0
  },
  "settlement_timeseries": []
}

Errors

  • 400 — outcome_id must be a non-negative integer.

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

Related