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 all HIP-4 outcomes currently active (or filterable to other statuses), each enriched with current Yes/No mid prices and lifetime activity rollups.

​
Endpoint

GET /v1/markets

​
Query parameters

ParamTypeDefaultDescription
statusstring"active"One of active, resolved, all
underlyingstring—Filter by underlying asset (e.g. BTC, ETH)
periodstring—Filter by recurrence period (1m, 1h, 1d, etc.)

​
Response

{
  "count": 1,
  "markets": [
    {
      "outcome_id": 0,
      "title": "BTC >= $78213 by 2026-05-03 06:00 UTC (1d)",
      "name": "Recurring",
      "status": "active",
      "class": {
        "raw": "priceBinary",
        "label": "Binary outcome (Yes / No)",
        "description": "Two-sided market that resolves on whether an underlying price crosses a target by an expiry."
      },
      "underlying": "BTC",
      "target_price": "78213",
      "period": {
        "raw": "1d",
        "label": "1 day",
        "description": "Recurring market with a 1 day cycle.",
        "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" },
      "question_id": null,
      "question_name": null,
      "sides": [
        { "side_index": 0, "label": "Yes", "coin": "#0", "asset_id": 100000000, "current_mid": "0.64832" },
        { "side_index": 1, "label": "No",  "coin": "#1", "asset_id": 100000001, "current_mid": "0.35168" }
      ],
      "lifetime": {
        "fills": 26732,
        "unique_traders": 1299,
        "volume_usdh": "1147289.829980"
      }
    }
  ]
}

​
Notes

  • Sorted by lifetime volume DESC.
  • current_mid per side is the most recent computed mid price (last_trade-based, matches HL’s allMids).
  • Cached at edge for 15 seconds.

​
Examples

curl -H "X-API-Key: hip4_live_..." \
  "https://hip4.polynode.dev/api/v1/markets?status=active"