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-detailsReturns 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
market_id
string
Yes
Unique HIP-4 market identifier
asset_id
number
No
Optional YES / NO outcome asset id
Example Request
Example Response
Example Request With Optional asset_id
Example Response
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.
Query Parameters
market_id
string
No
Filter assets by market id
asset_id
number
No
Filter by specific asset id
Example Request
Example Response
Example Request With asset_id
Example Response
Response Schema
Market Details
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
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
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
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
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
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.
Last updated