Skip to main content
POST
Burn shares
Burning is the reverse of minting. You surrender an equal number of YES and NO shares (a complementary pair) and receive funds back. Like minting, burning does not affect market prices since it removes both sides equally. This is useful for exiting a position when you hold both outcomes, or for converting shares back to cash. You must hold sufficient shares of both YES and NO to burn.

Authentication

Write authentication required — X-Public-Key, X-Timestamp, and X-Signature headers. See the Authentication guide.

Path parameters

string
required
UUID of the market.

Request body

number
required
Amount to redeem from the burn operation in the selected currency. For example, quantity: 100, currency: "NGN" means “burn enough complete-set inventory to receive 100 NGN”. Must be greater than 0.
string
USD (default) or NGN.
Request quantity is a wallet amount in the provided currency. The response quantity is the normalized share quantity burned.

Example request

Response

string
UUID of the burn operation.
string
UUID of the market.
number
Normalized share quantity burned.
number
Current price of outcome 1 (YES). Returned for convenience — burning does not change market prices.
number
Current price of outcome 2 (NO). Returned for convenience — burning does not change market prices.
number
Funds returned from the burn operation.