Split and Merge Outcomes

{
  "status": "ok",
  "response": {
    "type": "outcomeOperation",
    "data": {
      "actionId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "adapter": "hyperliquid",
      "operation": "merge",
      "status": "pending"
    }
  }
}

{
  "error": "No available outcome balance to merge",
  "code": "VALIDATION_FAILED",
  "timestamp": 1785254400000
}

{
  "error": "Invalid signature",
  "code": "UNAUTHORIZED",
  "timestamp": 1785254400000
}

{
  "error": "Polymarket position-operation policy is unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": 1785254400000,
  "retryAfter": 5
}

{
  "status": "ok",
  "response": {
    "type": "outcomeOperation",
    "data": {
      "actionId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "adapter": "hyperliquid",
      "operation": "merge",
      "status": "pending"
    }
  }
}

{
  "error": "No available outcome balance to merge",
  "code": "VALIDATION_FAILED",
  "timestamp": 1785254400000
}

{
  "error": "Invalid signature",
  "code": "UNAUTHORIZED",
  "timestamp": 1785254400000
}

{
  "error": "Polymarket position-operation policy is unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": 1785254400000,
  "retryAfter": 5
}

{
  "status": "ok",
  "response": {
    "type": "outcomeOperation",
    "data": {
      "actionId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "adapter": "hyperliquid",
      "operation": "merge",
      "status": "pending"
    }
  }
}

{
  "error": "No available outcome balance to merge",
  "code": "VALIDATION_FAILED",
  "timestamp": 1785254400000
}

{
  "error": "Invalid signature",
  "code": "UNAUTHORIZED",
  "timestamp": 1785254400000
}

{
  "error": "Polymarket position-operation policy is unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": 1785254400000,
  "retryAfter": 5
}

HyperliquidPolymarket

POST/exchange

Request Body

object

required

Signed action containing exactly one of splitOutcome or mergeOutcome. Requires protocol access and an account that is neither frozen nor in active liquidation.

Show child attributes

string

required

Must be "userOutcome".

Hyperliquid merge

object

required

Reserves equal Yes and No shares. Completion credits one USDC per complete set; failure releases the reserved shares.

Show child attributes

number

required

Nonnegative integer outcome ID from prediction metadata. Both sides must be USDC-quoted.

string | null

required

Positive integer complete-set count within both sides’ unreserved balances, or null to merge the maximum available whole sets. One set consumes one Yes and one No share. Exact retries reuse the original resolved amount.

Polymarket split and merge

object

Reserves available pUSD without borrowing; checks margin and existing borrow support after reservation. Completion credits equal Yes and No shares; failure releases pUSD. Omit mergeOutcome. The operation must be enabled; version 2 operation and market objects reject extra fields, and the request does not accept expiresAfter.

Show child attributes

number

required

Must be 2.

object

required

Supported, open Polymarket condition. The signed identities and negRisk must match the registered condition; use the matching sides from prediction metadata.

Show child attributes

string

required

Must be "polymarket".

string

required

Nonzero lowercase, 0x-prefixed 32-byte condition ID.

string

required

Canonical Yes-side AssetId matching the condition: 0x1001 followed by the token ID encoded as 64 lowercase hex characters.

string

required

Canonical No-side AssetId matching the condition, in the same format as yesAssetId. The two AssetIds must be distinct.

boolean

required

Negative-risk classification matching the condition.

string

required

Positive uint256 decimal integer string with no leading zeros, whitespace, or decimal point. In micro-pUSD: "500000" spends 0.5 pUSD to create 0.5 Yes and 0.5 No shares. An explicit amount is required; null is unsupported.

object

Uses the same schemaVersion, market, and amountBaseUnits fields and validation rules as splitOutcome. Omit splitOutcome. Here, amountBaseUnits is micro-shares of each side: "500000" merges 0.5 Yes and 0.5 No shares into 0.5 pUSD. Reserves equal unreserved Yes and No shares; failure releases them. The operation must be enabled.

number

required

Unique nonnegative safe integer nonce in Unix milliseconds; follow the nonce rules. Resend the identical signed request for a retry; it returns the existing operation state.

object

required

Account owner or approved API wallet; use the exchange signing format.

Show child attributes

string

required

ECDSA r component as a 0x-prefixed 32-byte hex string.

string

required

ECDSA s component as a 0x-prefixed 32-byte hex string.

number

required

ECDSA recovery value, for example 27.

Response

{
  "status": "ok",
  "response": {
    "type": "outcomeOperation",
    "data": {
      "actionId": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "adapter": "hyperliquid",
      "operation": "merge",
      "status": "pending"
    }
  }
}

{
  "error": "No available outcome balance to merge",
  "code": "VALIDATION_FAILED",
  "timestamp": 1785254400000
}

{
  "error": "Invalid signature",
  "code": "UNAUTHORIZED",
  "timestamp": 1785254400000
}

{
  "error": "Polymarket position-operation policy is unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": 1785254400000,
  "retryAfter": 5
}

Response Fields

string

"ok" when an operation state is returned; completion is reported in response.data.status. An exact retry can return "error" with a top-level error message.

string

Present when the top-level status is "error"; response is then omitted.

string

Always "outcomeOperation".

string

Stable operation ID. Query non-funding history with the account owner’s user address and this value as operationId to track settlement. An empty result can reflect read-replica delay.

string

"hyperliquid" or "polymarket".

string

"split" or "merge". Hyperliquid supports merge only.

string

pending: accepted; awaiting execution or confirmation.
active: execution recorded; awaiting confirmation. Polymarket only.
needs_reconciliation: outcome unconfirmed; funds remain reserved. Polymarket only.
completed: collateral or shares credited. Terminal.
failed: reservation released. Terminal.

Start Here

Info

Exchange

WebSocket

Request Body

Response

Response Fields

​Request Body

​Response

​Response Fields

Request Body

Response

Response Fields