Skip to main content
POST

Headers

​
X-API-Key
string

API key for authenticated access (alternative to Authorization header)

​
Authorization
string

Bearer sk_... — alternative to X-API-Key

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.

​
feeTipLamports
number

Tip in lamports. Public — min 0.001 SOL (1000000 lamports) enforced.

Required range: x >= 1000000
​
tipWallet
string

Custom tip recipient wallet (auth only).

​
tipLamports
number

Custom tip amount in lamports (auth only).

​
feeWallet
string

Custom fee recipient wallet (auth only).

​
feeBps
number

Custom fee in basis points (auth only). 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.