# HIP-4 Outcome Markets

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapplooker.com/products/api-endpoints/trading-intelligence/hip-4-outcome-markets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.