Skip to main content
POST
Exact-Out Swap Quote

Authorizations

X-Api-Key
string
header
required

API key (programmatic access — recommended)

Send your API key in the X-Api-Key header. Keys start with nxs_ and are created in the dashboard (or via POST /api/keys with a session JWT).

Each key is scoped to one chain and one network (for example CARDANO_MAINNET), fixed at creation time. It cannot query a different network on the same chain, and it cannot query a different chain at all. A mismatched network parameter returns 400 Network Mismatch. Create one key per chain and network under the same account.

This is the credential most integrations should use.

Headers

X-Partner-Payout-Address
string
X-Partner-Fee-Bps
integer<int32>
X-Partner-Api-Key-Id
string
X-Partner-Fee-Fixed-Lovelace
integer<int64>
X-Partner-Max-Fee-Lovelace
integer<int64>
X-Partner-Route-Policy
string

Query Parameters

network
string

Target Cardano network for per-network market-data instances (e.g. preview). Omit, or pass mainnet, for mainnet.

Body

application/json
tokenIn
string
tokenOut
string
amountOut
string
slippageTolerance
number<double>
excludeDexes
string[]
senderAddress
string
partnerPayoutAddress
string
partnerFeeBps
integer<int32>
partnerApiKeyId
string
partnerFeeFixedLovelace
integer<int64>
partnerMaxFeeLovelace
integer<int64>
routePolicy
object

Response

200 - */*

OK

routes
object[]
bestRouteIndex
integer<int32>