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

Body

application/json
​
config_version
integer
default:1
required

Use 1 for Community Token and 2 for Creator Token

Required range: x >= 0
​
max_sol_spend
number
required

Maximum amount of SOL to spend for the buy operation

Example:

1

​
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

Use the response to create a buy transaction.

​
config_version
integer<int32>
required

Protocol config version used for the quote.

Required range: x >= 0
​
max_lamport_spend
integer
required

Maximum amount of lamports to spend for the buy operation

Required range: x >= 0
​
max_sol_spend
number
required

Maximum amount of SOL to spend for the buy operation

​
minimum_out
integer
required

Minimum amount of tokens to receive from the buy operation

Required range: x >= 0
​
minimum_out_ui
number
required

Minimum amount of tokens to receive from the buy operation in UI format

​
mint
string
required

Mint address of the token being bought.

​
program_id
string
required

Heaven DEX program ID used.

​
slippage_bps
integer<int64>
required

Slippage tolerance applied (basis points).

Required range: x >= 0