Skip to main content
POST
Prepare a sell

Authorizations

x-api-key
string
header
required

Your API key, issued by Securitize. Send it in the x-api-key header on every request. The key identifies your partner account; investorId names the investor each call concerns.

Path Parameters

contractAddress
string
required

The stock's sell contract address, from your Securitize contact. A stock has a different address for buying.

Body

application/json
investorId
string
required

Securitize's id for the investor. The transaction is built for their linked wallet.

signedPrice
string
required

signedPrice from GET /stocks/realtime-price, unchanged and unexpired, for this stock.

slippageBps
string
required

The slippage the investor accepted, in basis points, as a string of digits.

Pattern: ^\d+$
assetAmount
string
required

Stock tokens to sell, in the token's base units.

Pattern: ^\d+$
minOutputAmount
string
required

The least USDC the investor accepts, in base units (6 decimals). Below this, the trade reverts and nothing moves. Work it out as assetAmount ÷ 10^tokenDecimals × bestBid × (1 − slippageBps ÷ 10,000) × 10^6, rounded down.

Pattern: ^\d+$

Response

The transaction for the investor's wallet to sign.

unsignedTransaction
string
required

A base64-encoded transaction for the stock's chain, already signed by Securitize and awaiting the investor's signature. Have it signed unchanged and submit it within 120 seconds.

additionalData
object