PreviewQuote

Error

A valid request URL is required to generate request examples

{
  "amount_out": "<string>",
  "min_amount_out": "<string>",
  "amount_in_usd_micros": "<string>",
  "amount_out_usd_micros": "<string>",
  "slippage_bps": 1,
  "fee_breakdown": {
    "components": [
      {
        "name": "<string>",
        "side": "<string>",
        "usd_micros": "<string>",
        "native": "<string>"
      }
    ],
    "dst_total_usd_micros": "<string>",
    "src_total_usd_micros": "<string>",
    "dst_gas_native": "<string>",
    "src_gas_native": "<string>"
  },
  "same_chain_swap": true,
  "fulfill_eta_secs": 1
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {}
  ]
}

POST

quote

preview

Error

A valid request URL is required to generate request examples

{
  "amount_out": "<string>",
  "min_amount_out": "<string>",
  "amount_in_usd_micros": "<string>",
  "amount_out_usd_micros": "<string>",
  "slippage_bps": 1,
  "fee_breakdown": {
    "components": [
      {
        "name": "<string>",
        "side": "<string>",
        "usd_micros": "<string>",
        "native": "<string>"
      }
    ],
    "dst_total_usd_micros": "<string>",
    "src_total_usd_micros": "<string>",
    "dst_gas_native": "<string>",
    "src_gas_native": "<string>"
  },
  "same_chain_swap": true,
  "fulfill_eta_secs": 1
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {}
  ]
}

rpc PreviewQuote(PreviewQuoteRequest) returns (QuotePreview)

Same pricing as GetQuote, minus the persistence. No quote hash is produced and nothing can be deposited against the result. Use it for the amount field of a swap form.

Request

string

required

Source chain name, lowercase.

string

required

Destination chain name, lowercase.

string

required

Source token address.

string

required

Destination token address.

string

required

Amount in the source token’s base units.

string

required

Native asset to deliver on the destination, in base units. Empty string for none.

uint32

Floor for the destination swap leg, in basis points.

uint32

Floor for the source swap leg, in basis points.

Referrer[]

Referrer addresses and their basis points, so the preview matches what the quote will charge.

There is no recipient or refund_address: nothing is bound.

Response

string

Expected output, net of every fee.

string

Floor implied by the applied slippage.

uint32

Slippage actually applied.

FeeBreakdown

Itemized costs, identical in shape to a quote’s.

bool

True when the pair resolves to a same-chain swap rather than a bridge.

string

Notional input value in USD micros. Optional.

string

Notional output value in USD micros. Optional.

uint64

Estimated seconds from deposit to fulfillment, the median over recent orders on the same chain pair and route type. Absent when there is no history and no configured default for the destination chain.

Notes

Preview and quote use the same pipeline, so the numbers agree at the same instant. They diverge only as the market moves between the two calls, which is why a confirmation screen should show a freshly fetched quote rather than the last preview. Errors are identical to GetQuote.

Authorizations

x-api-key

string

header

required

Body

application/json

src_chain

string

dst_chain

string

src_token

string

dst_token

string

amount_in

string

slippage_bps

integer<int32>

Required range: x >= 0

src_slippage_bps

integer<int32>

Required range: x >= 0

referrers

object[]

Show child attributes

gas_drop

string

Response

amount_out

string

min_amount_out

string

amount_in_usd_micros

string

amount_out_usd_micros

string

slippage_bps

integer<int32>

Required range: x >= 0

fee_breakdown

object

Show child attributes

same_chain_swap

boolean

fulfill_eta_secs

integer<int64>

Estimated seconds from deposit to fulfillment, the median of recent orders on this route. Absent when no estimate is available.

Required range: x >= 0

Reference

Blockchain

PreviewQuote

Request

Response

Notes

Authorizations

Body

Response

​Request

​Response

​Notes

Authorizations

Body

Response

Request

Response

Notes