Pro Pool API

Set Slot Fee

Set slot-offset based creator fee brackets on a pro pool. Useful for sniper resistance — charge high fees in the first few seconds after launch that decay over time.

Each Solana slot is ~400ms. When active, slot fees take precedence over market cap based creator fees. Only the pool creator can call this.

Example — 50% for first ~2s, 10% for next ~4s, then normal fees:

`slot_offset_upperbound`	`buy_fee_bps`	`sell_fee_bps`	Timing
`5`	`5000`	`5000`	First ~2 seconds (50%)
`15`	`1000`	`1000`	Next ~4 seconds (10%)

Set max_slot_offset: 15, max_fee_bps: 5000, enabled: true.

POST

pro

set-slot-creator-fee

Set Slot Fee

curl --request POST \
  --url https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee \
  --header 'Content-Type: application/json' \
  --data '
{
  "pool": "<string>",
  "payer": "<string>",
  "program_id": "<string>",
  "brackets": [
    {
      "buy_fee_bps": 5000,
      "sell_fee_bps": 5000,
      "slot_offset_upperbound": 5
    }
  ],
  "max_slot_offset": 1,
  "max_fee_bps": 1,
  "enabled": true,
  "compute_unit_limit": 1,
  "compute_unit_price": 1
}
'

import requests

url = "https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee"

payload = {
    "pool": "<string>",
    "payer": "<string>",
    "program_id": "<string>",
    "brackets": [
        {
            "buy_fee_bps": 5000,
            "sell_fee_bps": 5000,
            "slot_offset_upperbound": 5
        }
    ],
    "max_slot_offset": 1,
    "max_fee_bps": 1,
    "enabled": True,
    "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({
    pool: '<string>',
    payer: '<string>',
    program_id: '<string>',
    brackets: [{buy_fee_bps: 5000, sell_fee_bps: 5000, slot_offset_upperbound: 5}],
    max_slot_offset: 1,
    max_fee_bps: 1,
    enabled: true,
    compute_unit_limit: 1,
    compute_unit_price: 1
  })
};

fetch('https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee', 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/set-slot-creator-fee",
  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([
    'pool' => '<string>',
    'payer' => '<string>',
    'program_id' => '<string>',
    'brackets' => [
        [
                'buy_fee_bps' => 5000,
                'sell_fee_bps' => 5000,
                'slot_offset_upperbound' => 5
        ]
    ],
    'max_slot_offset' => 1,
    'max_fee_bps' => 1,
    'enabled' => true,
    '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/set-slot-creator-fee"

	payload := strings.NewReader("{\n  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\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/set-slot-creator-fee")
  .header("Content-Type", "application/json")
  .body("{\n  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\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/set-slot-creator-fee")

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  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\n  \"compute_unit_limit\": 1,\n  \"compute_unit_price\": 1\n}"

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

{
  "tx": "<string>"
}

Body

application/json

Set slot-offset based creator fee brackets on a pro pool. Useful for implementing time-decaying fees (e.g. high fees right after launch for sniper resistance that decay over slots).

pool

string

required

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

payer

string

required

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

program_id

string

required

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

brackets

object[]

required

Array of slot fee brackets (max 42). Each bracket defines buy/sell fees at a specific slot offset range from pool creation.

Show child attributes

max_slot_offset

integer<int32>

required

Maximum slot offset at which slot-based fees apply. After this many slots, the fees revert to normal.

Required range: x >= 0

max_fee_bps

integer<int32>

required

Maximum fee in basis points across all slot brackets.

Required range: x >= 0

enabled

boolean

required

Set to true to enable slot-based fees, false to disable them.

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 with the creator wallet, and submit.

Set Slot Fee

curl --request POST \
  --url https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee \
  --header 'Content-Type: application/json' \
  --data '
{
  "pool": "<string>",
  "payer": "<string>",
  "program_id": "<string>",
  "brackets": [
    {
      "buy_fee_bps": 5000,
      "sell_fee_bps": 5000,
      "slot_offset_upperbound": 5
    }
  ],
  "max_slot_offset": 1,
  "max_fee_bps": 1,
  "enabled": true,
  "compute_unit_limit": 1,
  "compute_unit_price": 1
}
'

import requests

url = "https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee"

payload = {
    "pool": "<string>",
    "payer": "<string>",
    "program_id": "<string>",
    "brackets": [
        {
            "buy_fee_bps": 5000,
            "sell_fee_bps": 5000,
            "slot_offset_upperbound": 5
        }
    ],
    "max_slot_offset": 1,
    "max_fee_bps": 1,
    "enabled": True,
    "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({
    pool: '<string>',
    payer: '<string>',
    program_id: '<string>',
    brackets: [{buy_fee_bps: 5000, sell_fee_bps: 5000, slot_offset_upperbound: 5}],
    max_slot_offset: 1,
    max_fee_bps: 1,
    enabled: true,
    compute_unit_limit: 1,
    compute_unit_price: 1
  })
};

fetch('https://tx.api.heaven.xyz/tx/pro/set-slot-creator-fee', 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/set-slot-creator-fee",
  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([
    'pool' => '<string>',
    'payer' => '<string>',
    'program_id' => '<string>',
    'brackets' => [
        [
                'buy_fee_bps' => 5000,
                'sell_fee_bps' => 5000,
                'slot_offset_upperbound' => 5
        ]
    ],
    'max_slot_offset' => 1,
    'max_fee_bps' => 1,
    'enabled' => true,
    '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/set-slot-creator-fee"

	payload := strings.NewReader("{\n  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\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/set-slot-creator-fee")
  .header("Content-Type", "application/json")
  .body("{\n  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\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/set-slot-creator-fee")

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  \"pool\": \"<string>\",\n  \"payer\": \"<string>\",\n  \"program_id\": \"<string>\",\n  \"brackets\": [\n    {\n      \"buy_fee_bps\": 5000,\n      \"sell_fee_bps\": 5000,\n      \"slot_offset_upperbound\": 5\n    }\n  ],\n  \"max_slot_offset\": 1,\n  \"max_fee_bps\": 1,\n  \"enabled\": true,\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

Set Slot Fee

Body

Response