Skip to main content
Naos Trade API lets you swap any token to any token and bridge native tokens across 15 blockchains with a single integration. Get quotes, sign transactions client-side, and execute on-chain — all through a simple REST API.

How it works

1

Get a quote

Call GET /api/v2/quote (swap) or GET /api/v1/bridge/quote (bridge) with your parameters. The API returns an unsigned transaction with price data and routing info.
2

Sign the transaction

Sign the returned transaction client-side using ethers.js (EVM) or @solana/web3.js (Solana). Your private key never leaves your application.
3

Execute on-chain

Send the signed transaction to POST /api/v2/execute (swap) or POST /api/v1/bridge/execute (bridge). The API broadcasts it, waits for confirmation, and returns the result.

Key features

Universal Routing

Swap any token to any token — not just native pairs. USDC to USDT, Token to USDC, or any combination with automatic optimal path finding via the Naos Trading Router.

Cross-Chain Bridge

Bridge native tokens between any supported chain. EVM to EVM, EVM to Solana, Solana to EVM — with a 0.25% fee.

MEV Protection

Built-in sandwich attack prevention with private mempool routing on EVM chains.

Token Intelligence

Get token metadata, pool info, buy/sell taxes, liquidity depth, market cap, and contract security audits — all in one call.

Endpoints overview

EndpointMethodDescription
/api/v2/quoteGETGet unsigned swap transaction with price quote
/api/v2/executePOSTExecute signed swap transaction on-chain
/api/v1/bridge/quoteGETGet unsigned bridge transaction with quote
/api/v1/bridge/executePOSTExecute signed bridge transaction and wait for completion
/api/v1/bridge/status/{requestId}GETCheck bridge status (timeout fallback)
/api/v1/bridge/networksGETList supported bridge networks with min/max
/api/v1/token-infoGETToken metadata, pool info, taxes, and audit
/api/v1/token-auditGETContract security audit
/api/v2/valueGETFast price estimate (no transaction)
/api/v1/priorityGETGas fee estimates per priority level
/api/v1/chainsGETList supported chains
/api/v1/balanceGETToken balance across chains
/api/healthGETHealth check (no auth)

Quick example

curl -X GET "https://api.naos.trade/api/v2/quote?\
tokenIn=0x0000000000000000000000000000000000000000&\
tokenOut=0xTokenAddress&\
amount=100000000000000000&\
slippage=500&\
trader=0xYourWallet&\
chain=BASE" \
-H "Authorization: Bearer YOUR_API_KEY"