Build Swap

post

https://api.vybenetwork.xyz/v4/trading/swap

Solana API endpoint for building token swaps. Build and return unsigned transactions for direct swaps on DEXs like Pump.fun, Raydium and more.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request payload model for swap proxy params parameters used by this API endpoint.

accountAddress

string

required

Typed Solana public key identifier used across request parameters and response fields.

amount

double

required

Amount to swap (in UI units)

autoCalculateSlippage

boolean | null

Auto-calculate optimal slippage

closeInputAta

boolean | null

When true, append closeAccount on input SPL ATA after a full-balance sell.

closeWsolAta

boolean | null

Ephemeral WSOL path on sell: create WSOL ATA, sync native, then close.

createOutputAta

boolean | null

Create output SPL ATA idempotently before swap (buy when wallet has no output ATA).

enrich

boolean | null

When true, ix-builder attaches print-ready enrichment (simulation, fees, USD, retention %)
on POST /v4/trading/swap responses. Forwarded verbatim to ix-builder; ignored by aggregators.

enumerateRoutes

boolean | null

Build multiple route candidates (up to 10). Default on; set false to stop at first success.

gasless

boolean | null

Use Vybe fee payer for gas

inputBalanceExact

string | null

Exact input balance from wallet token-balance (UI units); used with closeInputAta.

inputDecimals

int32 | null

≥ 0

Input token decimals when paired with inputBalanceExact (optional; on-chain fetch otherwise).

inputMintAddress

string

required

Typed Solana public key identifier used across request parameters and response fields.

inputMintDecimals

int32 | null

≥ 0

Input mint decimals from client cache.

inputMintPrice

double | null

Client USD price for the input mint (skips backend price fetch when set).

liquidity

double | null

Known USD pool liquidity from market discovery; forwarded to ix-builder as a hint for pinned swaps and route enrichment.
Accepts legacy marketScore as an alias.

marketFetchMode

string | null

Market discovery mode for Vybe router: "full" | "trades" | "rpc".

outputMintAddress

string

required

Typed Solana public key identifier used across request parameters and response fields.

outputMintDecimals

int32 | null

≥ 0

Output mint decimals from client cache.

outputMintPrice

double | null

Client USD price for the output mint (skips backend price fetch when set).

partner

string | null

Partner identifier for fee routing

poolAddress

string | null

The target liquidity pool address used when executing this swap request.

postSwapNeeded

boolean | null

Caller indicates a post-swap bridge leg is required after the main swap.

preSwapNeeded

boolean | null

Caller indicates a pre-swap bridge leg is required before the main swap.

programAddress

string | null

Typed Solana public key identifier used across request parameters and response fields.

protocol

string | null

enum

The swap protocol identifier used to route and execute this trade request.

quoteBridge

string

Quote-bridge metadata for multi-hop routes (ix-builder).

router

string

enum

Enumeration of supported swap proxy router values used by this API model.

Allowed:

simulate

boolean | null

Simulate transaction without building

slippage

double | null

Slippage tolerance in percentage (default: 0.5)

solPrice

double | null

Client USD SOL price when neither leg is SOL/WSOL (fee/rent USD).

source

string | null

Discovery source for pinned pool (trades, markets, rpc, …).

swapFee

double | null

Service fee percentage (e.g., 1 for 1%)

Responses

200Swap provided

400Invalid parameters — verify request inputs.

404No data matches provided query

500Internal server error