Skip to main content

Send Outcome Action REST API Endpoint

Submit a signed userOutcome action to the exchange. Use after Build Outcome Action to execute HIP-4 prediction market operations.

Updated on
May 19, 2026
info

Exchange API calls do not consume Quicknode API credits. Transactions through this endpoint are appended with a builder fee. See hyperliquidapi.com for a full breakdown. To white-label with your own builder code, contact us.

This endpoint is not a drop-in replacement for Hyperliquid's native /exchange endpoint. See the Exchange API Overview for key differences.


Body Parameters

action
object
REQUIRED

Wire-format userOutcome action from the Build Outcome Action response

type
string

Always "userOutcome"

splitOutcome
object

Sub-object for outcomeSplit actions. Contains outcome (integer) and amount (string).

mergeOutcome
object

Sub-object for outcomeMerge actions. Contains outcome (integer) and amount (string).

mergeQuestion
object

Sub-object for outcomeMergeQuestion actions. Contains question (integer) and amount (string).

negateOutcome
object

Sub-object for outcomeNegate actions. Contains question (integer), outcome (integer), and amount (string).

nonce
integer
REQUIRED

Nonce from the Build Outcome Action response (timestamp in milliseconds)

signature
object
REQUIRED

ECDSA signature of the hash from Build Outcome Action

r
string

Signature r value (0x-prefixed hex string)

s
string

Signature s value (0x-prefixed hex string)

v
integer

Signature v value (27 or 28)

Returns

success
boolean

Whether the action was successfully submitted

user
string

User address (0x-prefixed hex string)

exchangeResponse
object

Response from Hyperliquid exchange

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free