Solana Swap APIsSwap

Create Swap Instructions

View as Markdown
Returns Solana swap instructions for a given token pair and amount.

Headers

0x-api-keystringRequired
Visit dashboard.0x.org to get your API Key

Request

This endpoint expects an object.
amount_inlongRequired>=0
Input amount in its base units.
takerstringRequired

Base-58 encoded taker wallet address.

token_instringRequired

Input token mint, base-58 encoded. Use So11111111111111111111111111111111111111111 for native SOL.

token_outstringRequired

Output token mint, base-58 encoded. Use So11111111111111111111111111111111111111111 for native SOL.

disabled_sourceslist of stringsOptional

DEX sources to exclude from routing. Valid source names are returned by /enabled-sources.

recipientstringOptional

Base-58 encoded recipient for swap output. If output token is native SOL this must be the address of the recipient, else a valid token account for that output token mint.

reserve_transaction_byteslongOptional>=0Defaults to 0
Minimum bytes to reserve in the transaction for composing with additional instructions.
slippage_bpsintegerOptional0-10000Defaults to 50
Slippage tolerance in basis points.
swap_fee_ppmstringOptional

Comma-separated volume-based swap fees in parts per million. Must be provided together with swap_fee_recipient. Each entry must be between 0 and the per-app maximum (100_000 unless configured otherwise). A value of 0 disables that fee entry. Multiple fees on the same side are applied sequentially, each on the amount remaining after prior deductions — not the original amount. Fee amounts are rounded up to the nearest base unit.

swap_fee_recipientstringOptional

Comma-separated base-58 encoded recipients for the swap fees. Must be provided together with swap_fee_ppm. The number of entries must match swap_fee_ppm. If the respective token for swap_fee_side is native SOL this must be an address, else a valid token account for that token mint.

swap_fee_sidestringOptional

Comma-separated fee sides for each fee entry. Supported values are buy and sell. This field may be omitted only when every fee uses the default buy side. When provided, the number of entries must match swap_fee_ppm.

trade_surplus_cap_ppmintegerOptional0-1000000

Trade surplus cap in parts per million of the total realized trade size. Must be provided together with trade_surplus_recipient, or both fields must be omitted. A value of 0 disables trade surplus collection for the request. When 0x controls trade surplus collection, the request value is ignored and the configured 0x policy is applied instead. The transferred amount is capped relative to trade size.

trade_surplus_recipientstringOptional

Base-58 encoded recipient that should receive trade surplus. Must be provided together with trade_surplus_cap_ppm, or both fields must be omitted. If the output token is native SOL this must be an address, else a valid token account for that token mint. When 0x controls trade surplus collection, the request value is ignored and the configured 0x recipient is used instead.

Response

Swap instructions
address_lookup_tableslist of strings
Address Lookup Table addresses that must be included in the versioned transaction.
amount_outlong>=0
The estimated amount of the output token received from the swap, in its base units.
instructionslist of objects
The instructions to perform the swap.
zidstring

Unique 12-byte hex identifier for this request.

route_planlist of objects
List of swap legs comprising the swap.

Errors

4XX
Client Request Error
5XX
Server Error