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

Name	Type	Required	Description
`outcome_id`	integer	✓	Outcome market ID. Must be a non-negative integer.

Query parameters

Name	Type	Required	Description
`period`	string	–	4h, 1d, 1w, 1m, or all. Defaults to 1d.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip4-analytics/outcome/1?period=1w"

Example response

json

{
  "success": true,
  "outcome_id": 1,
  "period": "1w",
  "volume_usd": 8400000,
  "trades": 2840,
  "fees_usd": 4200,
  "unique_traders": 420,
  "timeseries": [
    { "timestamp": "2026-06-01T00:00:00Z", "volume_usd": 1200000, "trades": 410 },
    { "timestamp": "2026-06-02T00:00:00Z", "volume_usd": 1400000, "trades": 480 }
  ],
  "settlement_series": []
}

Errors

400 — outcome_id must be a non-negative integer.

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