Deposit Liquidity

POST

pro

add-liquidity

Deposit Liquidity

curl --request POST \
  --url https://tx.api.heaven.xyz/tx/pro/add-liquidity \
  --header 'Content-Type: application/json' \
  --data '
{
  "payer": "<string>",
  "mint": "<string>",
  "config_version": 1,
  "program_id": "<string>",
  "max_token_a": 1,
  "max_token_b": 1,
  "min_lp_tokens": 1,
  "pool": "<string>",
  "compute_unit_limit": 1,
  "compute_unit_price": 1
}
'

import requests

url = "https://tx.api.heaven.xyz/tx/pro/add-liquidity"

payload = {
    "payer": "<string>",
    "mint": "<string>",
    "config_version": 1,
    "program_id": "<string>",
    "max_token_a": 1,
    "max_token_b": 1,
    "min_lp_tokens": 1,
    "pool": "<string>",
    "compute_unit_limit": 1,
    "compute_unit_price": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    payer: '<string>',
    mint: '<string>',
    config_version: 1,
    program_id: '<string>',
    max_token_a: 1,
    max_token_b: 1,
    min_lp_tokens: 1,
    pool: '<string>',
    compute_unit_limit: 1,
    compute_unit_price: 1
  })
};

fetch('https://tx.api.heaven.xyz/tx/pro/add-liquidity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tx.api.heaven.xyz/tx/pro/add-liquidity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'payer' => '<string>',
    'mint' => '<string>',
    'config_version' => 1,
    'program_id' => '<string>',
    'max_token_a' => 1,
    'max_token_b' => 1,
    'min_lp_tokens' => 1,
    'pool' => '<string>',
    'compute_unit_limit' => 1,
    'compute_unit_price' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://tx.api.heaven.xyz/tx/pro/add-liquidity"

	payload := strings.NewReader("{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://tx.api.heaven.xyz/tx/pro/add-liquidity")
  .header("Content-Type", "application/json")
  .body("{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://tx.api.heaven.xyz/tx/pro/add-liquidity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "tx": "<string>"
}

Body

application/json

Deposit liquidity to a pro pool. The amounts deposited will be proportional to the current pool reserves. You receive LP tokens representing your share of the pool.

payer

string

required

Public key of the wallet that will sign and pay for the transaction.

mint

string

required

Mint address of the SPL token (token A) in the pool.

config_version

integer<int32>

required

Protocol config version. Use 1 for community tokens, 2 for creator tokens, 3 for pro pools.

Required range: x >= 0

program_id

string

required

Program ID of the Heaven DEX program. Use HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o for mainnet.

max_token_a

integer<int64>

required

Maximum amount of token A (native units) to deposit. The actual amount may be less to maintain the pool ratio.

Required range: x >= 0

max_token_b

integer<int64>

required

Maximum amount of SOL (lamports) to deposit. The actual amount may be less to maintain the pool ratio.

Required range: x >= 0

min_lp_tokens

integer<int64>

required

Minimum LP tokens to receive. Set to 0 to accept any amount. Higher values protect against slippage.

Required range: x >= 0

pool

string

required

On-chain address of the pro pool state account. Returned in the response when creating a pool.

compute_unit_limit

integer<int32> | null

Maximum compute units for the transaction. Higher values allow more complex operations but cost more. Defaults to a sensible value if omitted.

Required range: x >= 0

compute_unit_price

integer<int64> | null

Priority fee in micro-lamports per compute unit. Higher values increase transaction priority. Defaults to a sensible value if omitted.

Required range: x >= 0

Response

200 - application/json

string

required

Base64 encoded versioned transaction. Decode, sign, and submit.

Deposit Liquidity

curl --request POST \
  --url https://tx.api.heaven.xyz/tx/pro/add-liquidity \
  --header 'Content-Type: application/json' \
  --data '
{
  "payer": "<string>",
  "mint": "<string>",
  "config_version": 1,
  "program_id": "<string>",
  "max_token_a": 1,
  "max_token_b": 1,
  "min_lp_tokens": 1,
  "pool": "<string>",
  "compute_unit_limit": 1,
  "compute_unit_price": 1
}
'

import requests

url = "https://tx.api.heaven.xyz/tx/pro/add-liquidity"

payload = {
    "payer": "<string>",
    "mint": "<string>",
    "config_version": 1,
    "program_id": "<string>",
    "max_token_a": 1,
    "max_token_b": 1,
    "min_lp_tokens": 1,
    "pool": "<string>",
    "compute_unit_limit": 1,
    "compute_unit_price": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    payer: '<string>',
    mint: '<string>',
    config_version: 1,
    program_id: '<string>',
    max_token_a: 1,
    max_token_b: 1,
    min_lp_tokens: 1,
    pool: '<string>',
    compute_unit_limit: 1,
    compute_unit_price: 1
  })
};

fetch('https://tx.api.heaven.xyz/tx/pro/add-liquidity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tx.api.heaven.xyz/tx/pro/add-liquidity",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'payer' => '<string>',
    'mint' => '<string>',
    'config_version' => 1,
    'program_id' => '<string>',
    'max_token_a' => 1,
    'max_token_b' => 1,
    'min_lp_tokens' => 1,
    'pool' => '<string>',
    'compute_unit_limit' => 1,
    'compute_unit_price' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://tx.api.heaven.xyz/tx/pro/add-liquidity"

	payload := strings.NewReader("{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://tx.api.heaven.xyz/tx/pro/add-liquidity")
  .header("Content-Type", "application/json")
  .body("{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://tx.api.heaven.xyz/tx/pro/add-liquidity")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"payer\": \"<string>\",\n  \"mint\": \"<string>\",\n  \"config_version\": 1,\n  \"program_id\": \"<string>\",\n  \"max_token_a\": 1,\n  \"max_token_b\": 1,\n  \"min_lp_tokens\": 1,\n  \"pool\": \"<string>\",\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "tx": "<string>"
}

Getting started

About heaven

About $LIGHT

Developers

Brand

Security

Body

Response