Skip to main content
POST
/
swap
Returns an imperative swap transaction for the given quote
curl --request POST \
  --url https://quote-api.dflow.net/swap \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "quoteResponse": {
    "contextSlot": 1,
    "inAmount": "<string>",
    "inputMint": "<string>",
    "minOutAmount": "<string>",
    "otherAmountThreshold": "<string>",
    "outAmount": "<string>",
    "outputMint": "<string>",
    "priceImpactPct": "<string>",
    "routePlan": [
      {
        "data": "<string>",
        "inAmount": "<string>",
        "inputMint": "<string>",
        "inputMintDecimals": 1,
        "marketKey": "<string>",
        "outAmount": "<string>",
        "outputMint": "<string>",
        "outputMintDecimals": 1,
        "venue": "<string>"
      }
    ],
    "slippageBps": 1,
    "forJitoBundle": true,
    "outTransferFee": "<string>",
    "platformFee": {
      "amount": "<string>",
      "feeBps": 1,
      "mode": "outputMint"
    },
    "requestId": "<string>",
    "routingSlot": 1,
    "simulatedComputeUnits": 1,
    "skipPumpfunCashbackClaim": true
  },
  "userPublicKey": "<string>",
  "computeUnitPriceMicroLamports": 1,
  "destinationTokenAccount": {
    "associatedTokenAccount": {
      "owner": "<string>"
    }
  },
  "dynamicComputeUnitLimit": true,
  "feeAccount": "<string>",
  "includeJitoSandwichMitigationAccount": true,
  "outputCloseAuthority": "<string>",
  "perLegSlippage": true,
  "prioritizationFeeLamports": {
    "autoMultiplier": 1
  },
  "sponsor": "<string>",
  "sponsorExec": true,
  "wrapAndUnwrapSol": true
}
'
{
  "computeUnitLimit": 1,
  "lastValidBlockHeight": 1,
  "prioritizationFeeLamports": 1,
  "swapTransaction": "<string>",
  "prioritizationType": {
    "computeBudget": {
      "microLamports": 1,
      "estimatedMicroLamports": 1
    }
  }
}

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.

We recommend using the /order endpoint for new integrations. This endpoint is still available but /order is the preferred approach. For a code example, see the imperative trade recipe.

​
Need Help?

https://mintcdn.com/dflow/a8Yx7HBusmKl4Z7w/images/meteor-icons_discord.svg?fit=max&auto=format&n=a8Yx7HBusmKl4Z7w&q=85&s=0ea834bc8a9fa3fe161ba181329effda

Join Our Discord

Connect with other developers, get help, and stay updated on the latest DFlow developments.
https://mintcdn.com/dflow/a8Yx7HBusmKl4Z7w/images/meteor-icons_telegram.svg?fit=max&auto=format&n=a8Yx7HBusmKl4Z7w&q=85&s=e928c5dd68311ff0d419936a35c86eed

Dev Notifications

Join the DFlow Dev Notifications Telegram group to stay in the loop on new features and other announcements.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Contact hello@dflow.net to obtain an API key.

Body

application/json
​
quoteResponse
object
required

The response from the quote endpoint

​
userPublicKey
string
required

Base58-encoded address of the swapper's wallet

​
computeUnitPriceMicroLamports
integer<int64>

Compute unit price in micro-lamports. Mutually exclusive with prioritizationFeeLamports.

Required range: x >= 0
​
createFeeAccount
object

If the fee account isn't a referral token account derived from the seeds ["referral_ata", referral_account, mint] and the Referral program ID REFER4ZgmyYx9c6He5XfaTMiGfdLwRnkV4RPp9t9iF3, this should be unspecified. If specified, the transaction will create the fee_account if it doesn't already exist. The user pays for the creation of the fee account. Ignored if fee_account is unspecified.

​
destinationTokenAccount
object

The account that will receive the output token. If not specified, the user's associated token account for the output mint will be used. Allowed values are:

  • A base58-encoded address, which specifies the address of the destination token account or, if the output is native SOL, the destination wallet. If the output isn't native SOL, the specified account must exist before the swap executes, or else the swap will fail.
  • An object which specifies the owner of the destination token account. In this case, the owner's associated token account for the output mint will be used as the destination token account. Note that this cannot be used if the output is native SOL. The object contains the following:
    • associatedTokenAccount - object
      • owner - base58-encoded address of the owner of the destination token account
​
dynamicComputeUnitLimit
boolean

If true, the server will simulate the transaction to determine its compute unit limit. If unspecified or false, the transaction will use the default compute unit limit.

​
feeAccount
string

Base58-encoded address of the token account that will receive the platform fee if a platform fee applies to the swap. If specified, this account's mint must match the fee mint for the swap.

​
includeJitoSandwichMitigationAccount

If specified, the transaction will include a Jito sandwich mitigation account in the swap instruction. Allowed values are:

  • true - uses the default Jito sandwich mitigation account
  • false - does not include the account
  • A base58-encoded account address - uses the specified account

If unspecified, the account is not included. See https://docs.jito.wtf/lowlatencytxnsend/#sandwich-mitigation for more details.

​
outputCloseAuthority
string

Base58-encoded address of the close authority to assign to the output token account. If specified, the swap instruction will idempotently initialize the output token account and set its close authority to the specified address. The action is a no-op if the output token account already exists at execution time.

Cannot be used when the output mint is SOL (wrapped or native). Cannot be used with destinationTokenAccount.

​
perLegSlippage
boolean

If true or unspecified, per-leg slippage checks are enabled. If false, per-leg slippage checks are disabled.

​
positiveSlippage
object

Positive slippage fee parameters. If specified, then the swap will pay some or all positive slippage to the specified account.

​
prioritizationFeeLamports

Prioritization fee in lamports. Mutually exclusive with computeUnitPriceMicroLamports. If both computeUnitPriceMicroLamports and prioritizationFeeLamports are unspecified, the default of prioritizationFeeLamports="auto" will be used. Allowed values are:

  • a u32 which specifies the lamports
  • the string value "auto", where the server determines the fee automatically, capped at 0.005 SOL
  • the string value "disabled", where the server leaves the prioritization fee unspecified
  • an object containing the following
    • priorityLevelWithMaxLamports - object
      • priorityLevel - string, either medium, high, or veryHigh
      • maxLamports - integer, a cap on the prioritization fee
  • an object containing the following
    • autoMultiplier - a u32 which specifies how much to multiply the automatically determined fee by. The total prioritization fee will be capped at 0.005 SOL.
​
sponsor
string

Base58-encoded address of the sponsor's wallet. If specified, the sponsor will pay the transaction fee and for token account creation, and both the user and the sponsor must sign the swap transaction. This can be used to implement gasless swaps.

​
sponsorExec
boolean

If true, the sponsor will be the executor of the swap for sponsored swaps. If false, the user will be the executor of the swap for sponsored swaps. Default is true.

​
wrapAndUnwrapSol
boolean

If false, the transaction will use wrapped SOL

Response

Imperative swap transaction

​
computeUnitLimit
integer<int32>
required

Compute unit limit assigned to the transaction

Required range: x >= 0
​
lastValidBlockHeight
integer<int64>
required

The last block height at which the transaction is valid

Required range: x >= 0
​
prioritizationFeeLamports
integer<int64>
required

Prioritization fee in lamports

Required range: x >= 0
​
swapTransaction
string
required

Base64-encoded swap transaction. The user must sign before sending it to Solana.

​
prioritizationType
object

Prioritization fee type for the transaction