Skip to main content
POST
Price a swap

Authorizations

x-api-key
string
header
required

Body

application/json
originChain
integer
required

Chain the swap originates from (an EVM chain or Solana).

destinationChain
integer
required

Chain the swapped asset is delivered on (EVM or Solana).

inputToken
string
required

Origin-chain token address (or native/currency id) being sold.

outputToken
string
required

Destination-chain token address (or native/currency id) being bought.

amount
string
required

Input amount in the token’s smallest unit (e.g. USDC = 6 dp).

Pattern: ^\d+$
walletAddress
string
required

The agent wallet that originates the swap and signs it: the EVM address for EVM origin, or the base58 Solana address for Solana origin.

recipient
string

Where the output is delivered. Defaults to walletAddress; required for Solana origin.

slippageBps
integer

Max slippage in basis points. Defaults per-route (tight for stables, higher for volatile).

Required range: 0 <= x <= 10000

Response

200 - application/json

Default Response

geoQuoteToken
string
required

Opaque sealed quote; echo verbatim to POST /swap/build-geo-op or build-solana-tx.

Minimum string length: 1
origin
enum<string>
required

Origin family, telling the client which build/submit pair to use (evm or solana).

Available options:
evm,
solana
output
string
required

Estimated output amount, formatted in the destination token.

feeBps
number
required

App fee applied to the input, in basis points (may be fractional).

Required range: x >= 0
expiresAt
string<date-time>
required

ISO-8601 instant after which the quote is stale.

feeDiscount
object

Present when the origin wallet’s $GEO holdings earned a fee discount; feeBps already reflects the discounted value.

inputUsd
string

Indicative venue-priced USD value of the input amount at quote time. Omitted when USD pricing is unavailable for the pair.

outputUsd
string

Indicative venue-priced USD value of the estimated output at quote time. Omitted when USD pricing is unavailable for the pair.

priceImpactBps
number

All-in value change from inputUsd to outputUsd, in basis points, signed like swap UIs display impact: negative = the output is worth less than the input (includes price impact, network costs, and the app fee). Omitted when either USD value is unavailable.

warnings
(object | null)[]

Non-fatal notices about the quoted route (e.g. the Solana recipient holds too little SOL to ever swap the delivered asset back out, or a route losing an outsized share of the input value). The swap can proceed regardless.