Get a DEX swap quote

Get a DEX swap quote

get

Get a swap quote for a same-chain or cross-chain token swap.

Supported chains: solana, base.

Amount: must be in base units (integer string). Convert token amounts to base units before calling:

• 1 SOL = 1000000000 lamports

• 1 ETH = 1000000000000000000 wei

• 1 USDC = 1000000 (6 decimals on both chains)

Tokens: pass raw contract addresses. Common addresses:

• SOL native: So11111111111111111111111111111111111111112

• ETH native: 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

• USDC (Solana): EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

• USDC (Base): 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913

Restriction: at least one side must be USDC or the native token (SOL/ETH). Non-native to non-native swaps are not supported — swap to USDC first.

Cross-chain: set to_chain for bridge swaps. Minimum ~$5 per trade. Not every pair and direction can be routed — when no aggregator has a route the response is a 400 rather than a worse price.

Signing: pass the quote you pick to /api/v1/trade/prepare to get a transaction ready to sign. That gives you one signing path for every route and applies the network fee floor that keeps Solana bridge transactions from being dropped.

The transaction field on a quote is the raw payload from the routing provider, and its shape varies: a standard EVM transaction on Base, a serialized transaction for Solana same-chain, and routing instructions rather than a transaction for swaps out of Solana to another chain. Signing it directly works only for the first two, so swaps out of Solana to another chain must go through the prepare endpoint.

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Query parameters

chainstring · enumRequired

Source chain: 'solana' or 'base'

Example: basePossible values:

to_chainany ofOptional

Destination chain for cross-chain swap

string · enumOptionalPossible values:

from_tokenstringRequired

Sell token address

Example: 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

to_tokenstringRequired

Buy token address

Example: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913

amountstringRequired

Amount in base units (integer string, e.g. '1000000000')

Example: 1000000000000000000

wallet_addressstringRequired

Wallet address for quote personalisation

Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

to_wallet_addressany ofOptional

Destination wallet address for cross-chain swaps (required when bridging between EVM and Solana)

stringOptional

slippageinteger · max: 10000Optional

Slippage in bps (default 50 = 0.5%)

Default: 50

Responses

200

Swap quotes with unsigned transaction data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

get/api/v1/trade/quote

HTTPcURLJavaScriptPython

GET /api/v1/trade/quote?chain=base&from_token=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&to_token=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&amount=1000000000000000000&wallet_address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Accept: */*

{
  "quotes": [],
  "ANY_ADDITIONAL_PROPERTY": "anything"
}