Trading Data Model

Use this page as a reference for the key objects returned by the /order endpoint and where each one appears in the request/response flow. This page focuses on imperative trades.

We recommend using the /order endpoint for new integrations. The /quote, /swap, and /swap-instructions endpoints are still available but /order is the preferred approach.

High-Level Model

You request an Order, which returns a Quote and, if userPublicKey is provided, a Transaction to sign and submit. The response may include a routePlan (one or more legs) and an executionMode (sync or async).

Example (Trade SOL → USDC)

Input mint: SOL
Output mint: USDC Flow:

Call GET /order with inputMint, outputMint, and amount.
Inspect priceImpactPct, routePlan, and executionMode.
If transaction is returned, sign it and send it to Solana.
For async execution, poll GET /order-status.

Entity Reference

Order Request (Query Parameters)

Core parameters:

Field	Type	Notes
`inputMint`	string	Base58 input mint
`outputMint`	string	Base58 output mint
`amount`	integer	Input amount (scaled integer)
`userPublicKey`	string	Wallet; includes `transaction` in response
`slippageBps`	integer \| `"auto"`	Max allowed slippage
`priceImpactTolerancePct`	integer	Max price impact % override

Routing controls:

Field	Type	Notes
`dexes`	string	Comma-separated include list
`excludeDexes`	string	Comma-separated exclude list
`onlyDirectRoutes`	boolean	Force single-leg routes
`maxRouteLength`	integer	Max legs (ignored if `onlyDirectRoutes`)
`onlyJitRoutes`	boolean	Force JIT routes
`forJitoBundle`	boolean	Routes compatible with Jito bundles

Execution controls:

Field	Type	Notes
`allowSyncExec`	boolean	Allow sync execution
`allowAsyncExec`	boolean	Allow async execution
`restrictRevertMint`	boolean	Input must be revert mint for async

Fees and accounts:

Field	Type	Notes
`platformFeeMode`	enum	Fee collected from input/output
`platformFeeBps`	integer	Platform fee in bps
`feeAccount`	string	Token account for platform fees
`positiveSlippageFeeAccount`	string	Account for positive slippage
`positiveSlippageLimitPct`	integer	Cap on positive slippage fee
`sponsor`	string	Sponsor wallet (gasless)
`destinationTokenAccount`	string	Output token account
`destinationWallet`	string	Output wallet (ATA if needed)
`revertWallet`	string	Revert wallet for async orders

In POST /swap, if you set destinationTokenAccount.address and want native SOL output, pass the wallet address (owner) instead of the wallet’s WSOL associated token account address.

Transaction configuration:

Field	Type	Notes
`wrapAndUnwrapSol`	boolean	Use native SOL if true
`prioritizationFeeLamports`	integer \| enum	Priority fee or level
`computeUnitPriceMicroLamports`	integer	CU price (mutually exclusive)
`dynamicComputeUnitLimit`	boolean	Simulate to determine CU limit
`includeJitoSandwichMitigationAccount`	boolean \| string	Jito mitigation
`maxAccounts`	integer	Max number of accounts the transaction can use. Mutually exclusive with `reserveAccounts`.
`maxTransactionSize`	integer	Max transaction size in bytes. Mutually exclusive with `reserveTransactionSize`.
`reserveAccounts`	integer	Number of accounts to leave unused. The server ensures the transaction uses at most `TRANSACTION_MAX_ACCOUNTS - reserveAccounts` accounts. Use this when you add instructions to the transaction — specify only the unique accounts your additions will introduce, not accounts already in the transaction. Mutually exclusive with `maxAccounts`.
`reserveTransactionSize`	integer	Bytes to leave unused. The server ensures the transaction size is at most `TRANSACTION_MAX_SIZE - reserveTransactionSize` bytes. Use this when you add instructions to the transaction — specify the number of bytes your modifications will add. Mutually exclusive with `maxTransactionSize`.

Order Response (OrderResponse)

Field	Type	Notes
`inputMint`	string	Base58 input mint
`inAmount`	string	Max input amount (scaled integer)
`outputMint`	string	Base58 output mint
`outAmount`	string	Expected output amount (scaled integer)
`otherAmountThreshold`	string	Min output after fees
`minOutAmount`	string	Same as `otherAmountThreshold`
`slippageBps`	integer	Max slippage in bps
`priceImpactPct`	string	Estimated price impact
`contextSlot`	integer	Slot at evaluation time
`executionMode`	enum	`sync` or `async`
`routePlan`	array	Route legs (sync and known routes)
`platformFee`	object \| null	Platform fee if applied
`revertMint`	string	Revert mint for async orders
`transaction`	string	Base64 tx to sign/send
`lastValidBlockHeight`	integer	Last valid block height
`computeUnitLimit`	integer	Compute unit limit
`prioritizationFeeLamports`	integer	Priority fee in lamports
`prioritizationType`	object	Priority fee type

Route Leg (RoutePlanLeg)

Each leg is either a DynamicRoutePlanLeg or SingleMarketRoutePlanLeg. Common fields:

Field	Type	Notes
`venue`	string	Venue for the leg
`marketKey`	string	Market key for venue
`inputMint`	string	Input mint
`outputMint`	string	Output mint
`inAmount`	string	Max input amount
`outAmount`	string	Expected output amount
`inputMintDecimals`	integer	Input decimals
`outputMintDecimals`	integer	Output decimals
`data`	string	Present only on dynamic legs

Spot Trading

Recipes

Concepts

Trading Data Model

High-Level Model

Example (Trade SOL → USDC)

Entity Reference

Order Request (Query Parameters)

Order Response (OrderResponse)

Route Leg (RoutePlanLeg)

​High-Level Model

​Example (Trade SOL → USDC)

​Entity Reference

​Order Request (Query Parameters)

​Order Response (OrderResponse)

​Route Leg (RoutePlanLeg)

High-Level Model

Example (Trade SOL → USDC)

Entity Reference

Order Request (Query Parameters)

Order Response (OrderResponse)

Route Leg (RoutePlanLeg)