Skip to main content
POST

Authorizations

​
X-API-Key
string
header
required

Body

application/json

token → SOL → token atomic round-trip on the SAME mint, both legs in one transaction. The buy-back leg is chained onto the sell leg's slippage floor.

​
walletAddresses
string[]
required
Minimum array length: 1
​
tokenAddress
string
required
​
percentage
number

Percentage of holdings to sell on the first leg (0.01–100). Mutually exclusive with tokensAmount — exactly one is required.

Required range: 0.01 <= x <= 100
​
tokensAmount

Fixed token amount(s) to sell on the first leg. Single number applies to all wallets; array is per-wallet. Mutually exclusive with percentage.

​
slippageBps
integer
default:500
Required range: 0 <= x <= 10000
​
transactionsFeeLamports
number

Priority fee per transaction in lamports.

​
tipWallet
string

Tip recipient wallet. Omitted ⇒ no tip transfer.

​
tipLamports
number

Tip amount in lamports. Omitted ⇒ no tip transfer.

​
feeWallet
string

Platform-fee recipient wallet — any wallet you choose. Omitted ⇒ no percentage fee.

​
feeBps
number

Platform fee in bps, capped at 1000 (10%). Charged once on the combined SOL volume of both legs — see BuySellRequest.

​
jitoDontFront
boolean
​
maxHops
integer
Required range: 1 <= x <= 3
​
includeDex
​
excludeDex
​
encoding
enum<string>
default:base64
Available options:
base58,
base64

Response

Transactions generated — or success:false with error when the request is invalid or no route could be built.

​
success
boolean
required
Example:

true

​
transactions
string[]
required
​
amountsOut
(integer | null)[]

Per-tx built output amount (raw), index-aligned with transactions; null where no route was found for that wallet. Same semantics as on /swap/sol/buy.