Skip to main content
POST
Start share merge
Convert a complete set of outcome shares back into USDC: each 1 YES share plus 1 NO share becomes 1 USDC. Share merges are available on open order book markets that do not have margin trading enabled. Other markets return share_conversion_market_not_eligible. Creating a draft locks the YES and NO shares for amount until the merge finishes. Drafts expire quickly, so sign and submit promptly. An unsigned draft that expires moves to expired and releases the lock.

Body Parameters

string
required
Market condition id.
string
required
Complete sets to merge. This many YES shares and this many NO shares are burned and you receive this much USDC. Must be a positive multiple of the market’s lot size, 10^-amount_precision (see amount_precision on Get market by condition id). At most 6 decimal places.
Sign the returned message, then call Submit share merge with the hex signature (see that page). Track the result with Get share merge by pubkey.

Response

On success the API returns 201 Created with a Location header pointing to GET /share-merges/{pubkey}/.
object
Created share merge draft payload.
object
Empty object on success for this endpoint.
object | null
null on success. Error object on failed requests.

Errors