Skip to main content
Quoting Combos can be capital-intensive because pUSD may remain locked across related positions until every underlying market resolves. Collateral return identifies capital that no longer needs to remain locked and returns it as pUSD, making it available for new quotes while preserving any unmatched exposure.

How Collateral Return Works

Collateral return finds compatible Combo positions that offset one another. It decomposes those positions, merges complementary exposure back into pUSD, and leaves the remaining exposure in residual positions. For example, let Y(A) and N(A) represent the YES and NO positions for market A, and let A ^ B ^ C represent a three-leg Combo. Suppose the wallet holds:
The first leg of each Combo can be decomposed:
Y(A) and N(A) are complementary, so they merge into 1 pUSD per matched share. The two Y(…) positions remain in the wallet, preserving its unmatched exposure to the other legs.

Return Collateral

The workflow is plan-based: inspect the proposed position changes, execute that exact plan, wait for confirmation, and request another plan when more work remains. You need a Relayer API key. See Connect Your Account to create one before continuing.
Given a SecureClient configured with a Relayer API key, ensure the wallet has the required trading approvals:
Collateral return supports Deposit Wallet, Safe Wallet, and Proxy Wallet accounts. EOA accounts are not supported.
1

Request a Plan

First, request a plan based on the wallet’s current Combo positions.
2

Inspect the Plan

Next, inspect the plan before signing. It is an inspectable execution artifact, not just a transaction payload. Review its expected return and residual-position impact, and apply any application-specific limits.
3

Execute the Inspected Plan

Finally, execute the inspected plan and wait for the transaction to confirm.
await handle.wait() returns after the submitted plan’s transaction confirms. Request another plan only then, because the next plan is calculated from the resulting onchain state.
If execution fails, discard the plan and request a new one before retrying.

Handle a Truncated Plan

The service limits how much work one transaction can contain. When more work remains, each plan is one complete, executable chunk—not a partial transaction. Execute and confirm each chunk before requesting the next plan because every new plan depends on the resulting onchain state.
Use plan.truncated to determine whether more work remains after the current plan.

Understand Residual Positions

Collateral return only removes exposure that can be recombined into collateral. Any unmatched exposure remains in new residual positions. These positions preserve the wallet’s remaining economic exposure after the returned pUSD is removed. For example, complementary exposure to one underlying leg may unlock pUSD while the rest of each Combo remains open. Inspect the created positions before execution and include them in your normal Combo position sync after confirmation.