HIP-4 Outcome Markets

The HIP-4 Outcome Markets API provides normalized intelligence for Hyperliquid-native outcome assets through DappLooker’s unified API layer.

Instead of exposing raw exchange responses, DappLooker returns consistent, machine-readable data covering:

• Market metadata

• Outcome asset mappings

• Prices and implied probabilities

• Liquidity and volume

• Settlement data

• DappLooker-derived signals

• Agent-ready actions

This keeps integration simple: fewer API calls, more complete responses.

---

Endpoints

1. Get HIP-4 Market Details

GET /api/v1/trade/hip4/market-details

Returns complete market-level intelligence for a HIP-4 outcome market.

Includes:

• metadata

• YES / NO asset mappings

• prices

• implied probabilities

• liquidity and volume

• settlement data

• intelligence signals

• agent actions

---

Query Parameters

Parameter	Type	Required	Description
market_id	string	Yes	Unique HIP-4 market identifier
asset_id	number	No	Optional YES / NO outcome asset id

---

Example Request

curl --location 'https://api.dapplooker.com/api/v1/trade/hip4/market-details?market_id=btc-daily-20260506'

---

Example Response

{
  "success": true,
  "data": {
    "market_id": "btc-daily-20260506",
    "title": "BTC Daily Outcome Market",
    "description": "Binary outcome market settling against HyperCore BTC mark price.",
    "underlying": "BTC",
    "status": "active",
    "expiry_time": "2026-05-06T06:00:00Z",
    "settlement_source": "HyperCore BTC mark price",
    "assets": {
      "yes_asset": {
        "asset_id": 1042,
        "symbol": "BTC-YES",
        "outcome": "YES",
        "price": 0.62,
        "implied_probability": 0.62
      },
      "no_asset": {
        "asset_id": 1043,
        "symbol": "BTC-NO",
        "outcome": "NO",
        "price": 0.38,
        "implied_probability": 0.38
      }
    },
    "market_data": {
      "timestamp": "2026-05-06T04:30:00Z",
      "spread": 0.01,
      "volume_24h": 6050000,
      "trades_24h": 18420,
      "open_interest": 1280000,
      "liquidity_depth_1pct": 125000,
      "liquidity_depth_5pct": 430000
    },
    "settlement": {
      "status": "pending",
      "settlement_time": "2026-05-06T06:00:00Z",
      "settlement_source": "HyperCore BTC mark price",
      "settlement_value": null,
      "winning_outcome": null
    },
    "signals": {
      "signal": "yes_overpriced",
      "conviction_score": 0.74,
      "market_probability": 0.62,
      "estimated_fair_probability": 0.55,
      "expected_edge": 0.07,
      "risk_level": "high_volatility",
      "drivers": [
        "market probability above modeled probability",
        "elevated short-term BTC volatility",
        "time-to-expiry below 2 hours"
      ]
    },
    "agent_actions": [
      {
        "action": "sell_yes",
        "conviction_score": 0.74,
        "expected_edge": 0.07,
        "risk_level": "high_volatility",
        "max_size_hint": 2500,
        "reason": [
          "YES outcome appears overpriced",
          "sufficient liquidity available",
          "market nearing expiry"
        ]
      }
    ]
  }
}

---

Example Request With Optional asset_id

curl --location 'https://api.dapplooker.com/api/v1/trade/hip4/market-details?market_id=btc-daily-20260506&asset_id=1042'

---

Example Response

{
  "success": true,
  "data": {
    "market_id": "btc-daily-20260506",
    "asset_id": 1042,
    "symbol": "BTC-YES",
    "outcome": "YES",
    "price": 0.62,
    "implied_probability": 0.62,
    "liquidity_depth_1pct": 125000,
    "liquidity_depth_5pct": 430000,
    "volume_24h": 3200000,
    "signal": "yes_overpriced",
    "conviction_score": 0.74,
    "expected_edge": 0.07,
    "risk_level": "high_volatility"
  }
}

---

2. Get Outcome Assets

Returns normalized HIP-4 outcome asset mappings.

Use this endpoint to discover YES / NO assets, asset ids, symbols, market links, and active outcome markets.

GET /api/v1/trading/hip4/assets

---

Query Parameters

Parameter	Type	Required	Description
market_id	string	No	Filter assets by market id
asset_id	number	No	Filter by specific asset id

---

Example Request

curl --location 'https://api.dapplooker.com/api/v1/trading/hip4/assets?market_id=btc-daily-20260506'

---

Example Response

{
  "success": true,
  "data": [
    {
      "asset_id": 1042,
      "market_id": "btc-daily-20260506",
      "underlying": "BTC",
      "outcome": "YES",
      "symbol": "BTC-YES",
      "status": "active"
    },
    {
      "asset_id": 1043,
      "market_id": "btc-daily-20260506",
      "underlying": "BTC",
      "outcome": "NO",
      "symbol": "BTC-NO",
      "status": "active"
    }
  ]
}

---

Example Request With asset_id

curl --location 'https://api.dapplooker.com/api/v1/trade/hip4/assets?asset_id=1042'

---

Example Response

{
  "success": true,
  "data": {
    "asset_id": 1042,
    "market_id": "btc-daily-20260506",
    "underlying": "BTC",
    "outcome": "YES",
    "symbol": "BTC-YES",
    "status": "active"
  }
}

---

Response Schema

Market Details

Field	Type	Description
market_id	string	Unique HIP-4 market identifier
title	string	Market title
description	string	Market description
underlying	string	Underlying asset or reference market
status	string	Market status
expiry_time	string	Market expiry timestamp
settlement_source	string	Source used for settlement

Assets

Field	Type	Description
asset_id	number	HIP-4 outcome asset id
symbol	string	Outcome asset symbol
outcome	string	YES or NO
price	number	Current normalized price
implied_probability	number	Price converted into probability

Market Data

Field	Type	Description
spread	number	YES / NO market spread
volume_24h	number	24h trading volume
trades_24h	number	24h trade count
open_interest	number	Current open interest
liquidity_depth_1pct	number	Liquidity within 1%
liquidity_depth_5pct	number	Liquidity within 5%

Settlement

Field	Type	Description
status	string	pending or settled
settlement_time	string	Expected or final settlement time
settlement_value	number/null	Final settlement value
winning_outcome	string/null	Winning outcome after settlement

Signals

Field	Type	Description
signal	string	DappLooker-derived market signal
conviction_score	number	Confidence score from 0 to 1
market_probability	number	Current market-implied probability
estimated_fair_probability	number	DappLooker estimated fair probability
expected_edge	number	Difference between market and fair probability
risk_level	string	Risk classification
drivers	array	Factors behind the signal

Agent Actions

Field	Type	Description
action	string	Suggested action for agents
conviction_score	number	Confidence score
expected_edge	number	Estimated edge
risk_level	string	Risk classification
max_size_hint	number	Suggested maximum notional size
reason	array	Explanation for the action

---

Integration Note

Use Get HIP-4 Market Details as the primary integration endpoint.

Use Get Outcome Assets only when you need asset discovery or mapping.

This keeps the integration surface minimal while still exposing the full HIP-4 intelligence layer.