Skip to main content
POST
/
quote
/
sell
Quote Sell
curl --request POST \
  --url https://tx.api.heaven.xyz/quote/sell \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount_in_ui": 100,
  "config_version": 1,
  "mint": "LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777",
  "program_id": "HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o",
  "slippage_bps": 50
}
'
{
  "amount_in": 1,
  "amount_in_ui": 123,
  "config_version": 1,
  "minimum_out": 1,
  "minimum_out_ui": 123,
  "mint": "<string>",
  "program_id": "<string>",
  "slippage_bps": 1
}

Body

application/json
​
amount_in_ui
number
required

Amount of tokens to sell in UI format

Example:

100

​
config_version
integer
default:1
required

Use 1 for Community Token and 2 for Creator Token

Required range: x >= 0
​
mint
string
required

Mint address of the token

Example:

"LiGHtkg3uTa9836RaNkKLLriqTNRcMdRAhqjGWNv777"

​
program_id
string
default:HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o
required

Program ID of the Heaven DEX program

​
slippage_bps
integer
required

Slippage in basis points (bps), e.g., 50 bps = 0.5%

Required range: x >= 0
Example:

50

Response

200 - application/json
​
amount_in
integer<int64>
required

Amount of tokens to sell (native units).

Required range: x >= 0
​
amount_in_ui
number<double>
required

Amount of tokens to sell (human-readable with decimals).

​
config_version
integer<int32>
required

Protocol config version used for the quote.

Required range: x >= 0
​
minimum_out
integer<int64>
required

Minimum SOL output after slippage (lamports).

Required range: x >= 0
​
minimum_out_ui
number<double>
required

Minimum SOL output after slippage (human-readable).

​
mint
string
required

Mint address of the token being sold.

​
program_id
string
required

Heaven DEX program ID used.

​
slippage_bps
integer<int64>
required

Slippage tolerance applied (basis points).

Required range: x >= 0