> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/trading-intelligence/hip-4-outcome-markets.md).

# 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

```shellscript
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

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

***

### Example Response

```json
{
  "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`

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

***

### Example Response

```json
{
  "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

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

***

### Example Response

```json
{
  "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`

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

***

### Example Response

```json
{
  "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.