> ## Documentation Index
> Fetch the complete documentation index at: https://pond.dflow.net/llms.txt
> Use this file to discover all available pages before exploring further.
# Trading Data Model
> How trading data is structured around `/order` requests
Use this page as a reference for the key objects returned by the [`/order
`](/resources/trading-api/order/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).
```mermaid theme={null}
flowchart TD
OrderRequest -->|returns| OrderResponse
OrderResponse -->|may_include| Transaction
OrderResponse -->|may_include| RoutePlanLeg
Transaction -->|submit| SolanaRPC
SolanaRPC -->|track| OrderStatus
```
## Example (Trade SOL → USDC)
**Input mint**: SOL\
**Output mint**: USDC
Flow:
1. Call [`GET /order`](/resources/trading-api/order/order) with `inputMint`,
`outputMint`, and `amount`.
2. Inspect `priceImpactPct`, `routePlan`, and `executionMode`.
3. If `transaction` is returned, sign it and send it to Solana.
4. For async execution, poll [`GET /order-status`](/resources/trading-api/order/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 |
| `predictionMarketSlippageBps` | integer \| `"auto"` | Slippage for prediction orders |
| `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 |
| `platformFeeScale` | integer | Prediction market fee scale (3 decimals) |
| `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`. |
Prediction market parameters:
| Field | Type | Notes |
| ----------------------------- | ------ | --------------------------------- |
| `predictionMarketInitPayer` | string | Pays market init if uninitialized |
| `outcomeAccountRentRecipient` | string | Rent recipient on close |
### 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 |
| `predictionMarketSlippageBps` | integer | Prediction order slippage |
| `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 |
| `initPredictionMarketCost` | integer | Lamports to init market |
| `predictionMarketInitPayerMustSign` | boolean | Init payer signature required |
| `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 |