Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

Returns everything we know about one outcome: parsed metadata, current top-of-book quotes, lifetime stats, resolution info if resolved.

Endpoint

GET /v1/markets/:id
The :id is the outcome_id (integer).

Response

{
  "outcome_id": 0,
  "title": "BTC >= $78213 by 2026-05-03 06:00 UTC (1d)",
  "name": "Recurring",
  "description_raw": "class:priceBinary|underlying:BTC|expiry:20260503-0600|targetPrice:78213|period:1d",
  "status": "active",
  "class": { "raw": "priceBinary", "label": "Binary outcome (Yes / No)", "description": "..." },
  "underlying": "BTC",
  "target_price": "78213",
  "period": { "raw": "1d", "label": "1 day", "description": "...", "applies_to": "86400" },
  "expiry": { "us": 1777788000000000, "iso": "2026-05-03T06:00:00+00:00", "relative": "in 12h" },
  "deployed_at": { "us": 1777727054207215, "iso": "...", "relative": "4h ago" },
  "resolved_at": null,
  "winning_side": null,
  "resolution_value": null,
  "question_id": null,
  "question_name": null,
  "sides": [
    {
      "side_index": 0, "label": "Yes",
      "coin": "#0", "asset_id": 100000000,
      "current_mid": "0.64832",
      "top_bid": "0.6478",
      "top_ask": "0.64882"
    },
    {
      "side_index": 1, "label": "No",
      "coin": "#1", "asset_id": 100000001,
      "current_mid": "0.35168",
      "top_bid": "0.35118",
      "top_ask": "0.3522"
    }
  ],
  "lifetime": {
    "fills": 26732,
    "unique_traders": 1299,
    "volume_usdh": "1147289.829980"
  }
}
FieldDescription
description_rawOriginal pipe-encoded HL description string
top_bid / top_askBest limit order resting in the book per side
winning_sideIndex of the winning side (0 or 1) once resolved; null while active
resolution_valueFinal value of the underlying at resolution (e.g. BTC price for a price binary)

404

HTTP 404
{"error":"outcome 9999 not found"}

Examples

curl -H "X-API-Key: hip4_live_..." \
  https://hip4.polynode.dev/api/v1/markets/0