Skip to main content
POST

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
walletAddresses
string[]
required
Minimum array length: 1
Example:
​
tokenAddress
string
required
Example:

"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

​
solAmount
number

Uniform SOL amount per wallet. Required if amounts not provided (SOL input only).

Example:

0.1

​
amounts
number[]

Per-wallet SOL amounts. Required if solAmount not provided (SOL input only).

Example:
​
inputMint
string

Input token mint. Omit for native SOL input. Use for non-SOL → token swaps.

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
inputAmountRaw
integer

Raw input amount in token base units. Required when inputMint is provided.

Example:

1000000

​
slippageBps
integer
default:500

Slippage tolerance in basis points. Defaults to 500 (5%) when omitted.

Required range: 0 <= x <= 10000
Example:

500

​
transactionsFeeLamports
number

Priority fee per transaction in lamports

Example:

100000

​
tipWallet
string

Tip recipient wallet. Omitted ⇒ no tip transfer.

​
tipLamports
number

Tip amount in lamports. Omitted ⇒ no tip transfer.

Example:

1000000

​
feeWallet
string

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

​
feeBps
number

Platform fee in bps, capped on-chain at 1000 (10%). Omitted ⇒ no percentage fee. Charged only on routes built through the Raze CPI router.

Example:

50

​
feeOnInput
boolean

Take on-chain CPI fee from input token (true) or output (false). Omitted uses router default (SOL/stable side).

​
jitoDontFront
boolean

Append JITO_DONT_FRONT marker. Only safe for a single non-bundled tx — Jito rejects bundles containing this marker. Default false.

​
tokensAmount

exactOut buy — exact output token qty (human units, ×1e6 like sells). Pair with swapMode exactOut.

​
swapMode
enum<string>

exactIn (default, spend solAmount) or exactOut (receive tokensAmount)

Available options:
exactIn,
exactOut
​
maxHops
integer

Cap route search depth (1–3 hops)

Required range: 1 <= x <= 3
​
includeDex

Only route through these DEXes (array or CSV). Labels match quote route[].dex.

​
excludeDex

Never route through these DEXes. Wins over includeDex.

​
recipient
string

Output-token recipient wallet. Omitted or equal to payer ⇒ self-buy. Distinct wallet ⇒ token lands in recipient ATA (payer signs+funds; recipient never signs). CPI-router only.

​
routeTicket
string

Route ticket from a /quote response. Wallets whose amount equals the ticket's amountIn build EXACTLY the quoted plan (no re-quote); wallets with a different amount re-quote normally. Expired ticket ⇒ 409 route_expired (whole request); malformed/forged ⇒ 400 invalid_route_ticket; different pair or swap mode ⇒ 400 route_ticket_mismatch.

​
encoding
enum<string>
default:base64
Available options:
base58,
base64

Response

Transactions generated

​
success
boolean
required
Example:

true

​
transactions
string[]
required

Unsigned transactions ready to be signed and submitted

​
amountsOut
(integer | null)[]

Per-tx built output amount (raw), index-aligned with transactions; null where no route was found for that wallet. This is what the transaction actually delivers (its on-chain min_return) — it can sit below the amountOut a prior /quote returned when the best-priced plan didn't fit the wire and a lower-output alternative was served.