Skip to main content
POST
Start share split
Convert USDC into a complete set of outcome shares: each 1 USDC becomes 1 YES share and 1 NO share. Share splits 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 USDC for amount until the split 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
USDC to split. You receive this many YES shares and this many NO shares. 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 split with the hex signature (see that page). Track the result with Get share split by pubkey.

Response

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

Errors