Get Quote

Returns a quote for an imperative swap

curl --request GET \
  --url https://quote-api.dflow.net/quote \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://quote-api.dflow.net/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://quote-api.dflow.net/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://quote-api.dflow.net/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://quote-api.dflow.net/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

GET

quote

Returns a quote for an imperative swap

curl --request GET \
  --url https://quote-api.dflow.net/quote \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://quote-api.dflow.net/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://quote-api.dflow.net/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://quote-api.dflow.net/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://quote-api.dflow.net/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

{
  "code": "<enum<string>>",
  "msg": "<string>"
}

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 Send Orders recipe.

This endpoint supports transactionVersion for v1 route simulation. See the v1 migration guide for details.

Authorizations

x-api-key

string

header

required

API key for authentication. Apply for one at https://pond.dflow.net/get-started/api-key

Query Parameters

inputMint

string

required

Base58-encoded input mint address

outputMint

string

required

Base58-encoded output mint address

amount

integer<int64>

required

Input amount as a scaled integer. For example, 1 SOL is 1000000000.

Required range: x >= 0

slippageBps

Max allowed slippage for the swap. Allowed values are:

a u16 which specifies the maximum allowed slippage in basis points
the string value "auto", where the server determines the maximum allowed slippage automatically Slippage tolerance specified in basis points

Required range: x >= 0

priceImpactTolerancePct

integer<int32>

If specified, the API will return an error if the price impact of the route is greater than the specified percentage. If unspecified, the server will determine the threshold. For example, 10 is 10% and 100 is 100%.

Required range: x >= 0

dexes

string

Comma-separated list of DEXes to include. If not specified, all DEXes will be included.

excludeDexes

string

Comma-separated list of DEXes to exclude. If not specified, all DEXes will be included.

platformFeeBps

integer<int32>

Optional platform fee in basis points. This should only be nonzero if the swap will collect the platform fee. The swap must specify a valid fee account and that fee account must be able to collect the fee mint at execution time.

Required range: x >= 0

platformFeeMode

enum<string>

Optional platform fee mode. If not specified, the default is outputMint.

Available options:

outputMint,

inputMint

sponsoredSwap

boolean

This should be specified as true if and only if the quote will be used for a sponsored swap. If true, then the quote will account for any additional token 2022 transfer fees that apply to the input and output mints for a sponsored swap.

The execution mode that will be used for the sponsored swap. This parameter is only relevant when sponsoredSwap is true. True indicates that the sponsor will be the executor of the swap. False indicates that the user will be the executor of the swap. Default is true.

destinationSwap

boolean

This should be specified as true if and only if the quote will be used for a destination token account swap. If true, then the quote will account for any additional token 2022 transfer fees that apply to the output mint for a destination token account swap.

onlyDirectRoutes

boolean

If true, only use single-leg routes

maxRouteLength

integer<int32>

If specified, the route will be limited to the specified number of legs. Ignored if only_direct_routes is true.

Required range: x >= 0

onlyJitRoutes

boolean

If true, only use JIT routes. Every leg in the route will use the JIT router.

forJitoBundle

boolean

If true, only use routes that are compatible with Jito bundles. This should only be specified as true if the swap will be executed in a Jito bundle. Default is false.

skipPumpfunCashbackClaim

boolean

If true, Pump.fun cashback will not be claimed for cashback-eligible coins. When set, sell quotes include the full creator fee, and execution skips Pump.fun cashback claiming. Default is false. Cannot be used with sponsor-executed swaps (sponsorExec is true or defaulted to true).

transactionVersion

enum<string>

default:v0

Wire format the quoted route must fit. Default is v0. This does not change the quote response itself, but v1's larger envelope admits routes that a v0 transaction cannot carry, so it should match the transactionVersion passed to the swap endpoint. Wire format of the transaction returned to the client.

Available options:

v0,

v1

Example:

"v0"

Response

Imperative swap quote

contextSlot

integer<int64>

required

Slot at which the request was evaluated

Required range: x >= 0

inAmount

string

required

Maximum input amount as a scaled integer. For example, 1 SOL is 1000000000.

inputMint

string

required

Base58-encoded input mint address

minOutAmount

string

required

Same as other_amount_threshold

otherAmountThreshold

string

required

Minimum output amount after all fees as a scaled integer. If the swap transaction doesn't produce at least this amount of the output token, the transaction will fail.

outAmount

string

required

Expected output amount after all fees as a scaled integer. For example, 1 SOL is 1000000000.

outputMint

string

required

Base58-encoded output mint address

priceImpactPct

string

required

Price impact of the swap. This is an estimate of the percentage difference between the expected price for the swap and the price for the same swap with the smallest input amount possible. For example, "0.01" means 1% price impact.

routePlan

object[]

required

Route that the swap will take

Option 1
Option 2

Show child attributes

slippageBps

integer<int32>

required

Max allowed slippage % in basis points

Required range: x >= 0

forJitoBundle

boolean

True if and only if the request was for a Jito bundle

outTransferFee

string

Transfer fee amount that was applied to the quote, if any

platformFee

null | object

Platform fee that was applied to the quote, if any

Show child attributes

requestId

string

Identifier for the request

routingSlot

integer<int64>

Slot of the market state used to compute the quote

Required range: x >= 0

simulatedComputeUnits

integer<int32>

Compute units consumed by quote simulation

Required range: x >= 0

skipPumpfunCashbackClaim

boolean

True if and only if Pump.fun cashback claiming was skipped for this quote

Troubleshooting

Trading API

Equities Submit API

Proof API

Authorizations

Query Parameters

Response