Skip to main content
POST
/
api
/
v2
/
execute
execute
curl --request POST \
  --url https://api.naos.trade/api/v2/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trade": "<string>",
  "mev": true,
  "simulation": true,
  "quoteId": "<string>",
  "approve": "<string>",
  "extra": "<string>",
  "reward": "<string>"
}
'
{
  "success": true,
  "txRes": {
    "traderAddress": "<string>",
    "fromToken": "<string>",
    "toToken": "<string>",
    "received": "<string>",
    "spent": "<string>",
    "txHash": "<string>",
    "network": "<string>",
    "explorerUrl": "<string>",
    "rewardWallet": "<string>"
  },
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

API key via Authorization: Bearer YOUR_API_KEY

Body

application/json
trade
string
required

Signed trade transaction

chain
enum<string>
required

Blockchain to broadcast the transaction

Available options:
BASE,
ETH,
BSC,
ARB,
AVAX,
ABS,
HYPE,
INK,
STORY,
XLAYER,
PLASMA,
UNI,
MONAD,
MEGAETH,
SOL
mev
boolean
required

Enable MEV protection (sandwich attack prevention, private mempool routing)

simulation
boolean
required

Run pre-flight transaction simulation, at a time cost

quoteId
string
required

Quote ID from /api/v2/quote response

approve
string

Signed approval transaction (EVM only)

extra
string

Signed extra transaction that may be required for some tokens

reward
string

Address to receive kickback rewards from healthy backrun arbitrage (requires mev)

Response

Transaction processed — check success field for actual result

success
boolean
required

Whether the transaction executed successfully

status
enum<string>

Transaction execution status

Available options:
SUCCESS,
FAILED
txRes
object

Transaction result details (present even on failure)

error
string | null

Human-readable error message

parsedError
enum<string> | null

Machine-readable error code for programmatic handling

Available options:
INSUFFICIENT_FUNDS,
INSUFFICIENT_ALLOWANCE,
INVALID_SIGNATURE,
SLIPPAGE_ERROR,
PRICE_IMPACT,
INSUFFICIENT_LIQUIDITY,
INSUFFICIENT_INPUT_AMOUNT,
ALREADY_LAUNCHED,
TRADING_NOT_ENABLED,
TIMEOUT_ERROR,
BLOCKHASH_NOT_FOUND,
OUT_OF_GAS,
INCORRECT_NONCE,
EXPIRED_NONCE,
COOLDOWN,
TOKEN_MIGRATING,
WHITELIST_ERROR,
WHITELIST_LIMIT_ERROR,
TRANSACTION_FAILED,
TRANSFER_FAILED,
COALESCE_ERROR,
ROUTER_NO_SWAP_STEPS,
ROUTER_WRONG_STEPS,
ROUTER_UNSUPPORTED_POOL,
ROUTER_DEADLINE_EXPIRED,
ROUTER_NATIVE_SEND_FAILED,
JUPITER_GAS_ERROR,
JUPITER_GAS_MAYBE_ERROR