ToolVet
80trust / 100

Swap Quote

by dexswap-quote in Onchain & crypto

x402 APIPassing, checked 2 h ago

Non-custodial swap calldata for Base: give tokenIn, tokenOut, raw amountIn, slippage and recipient; we read Aerodrome and Uniswap V3 on-chain state, pick the max-output route, and return ready-to-sign transaction calldata plus the ERC-20 approval, amountOutMin, price impact and the venues compared. You sign with your own wallet — we never hold or move funds.

GET https://api.agentstools.dev/swap/quote

Last 30 days

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed

Uptime
100%
Response time
27 ms typical, 129 ms slowest 5%
Last check
2 h ago
Next check
any minute now

How to call it

GET https://api.agentstools.dev/swap/quote

Each call costs $0.05 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

GET https://api.agentstools.dev/swap/quote?amountIn=1000000000000000000&recipient=0x1111111111111111111111111111111111111111&slippageBps=50&tokenIn=WETH&tokenOut=USDC

Parameters

ParameterTypeRequiredDescription
amountInstringYesSell amount in RAW atomic units of tokenIn (e.g. 1 WETH = 1000000000000000000). Integer as string.
deadlineSecondsintegerNoSeconds from now until the swap deadline. Default 600.
recipientstringYes0x address that receives tokenOut (baked into the calldata).
slippageBpsintegerNoMax slippage in basis points (50 = 0.5%). Default 50, max 5000.
tokenInstringYesSell token: a supported symbol (WETH, USDC, AERO, ...) or a 0x ERC-20 address on Base.
tokenOutstringYesBuy token: a supported symbol or a 0x ERC-20 address on Base.

Example response

The provider's example. We can't check it without paying.

Example response, 48 lines
{
  "approval": {
    "amountRaw": "1000000000000000000",
    "data": "0x095ea7b3...",
    "spender": "0x2626664c..."
  },
  "buyToken": {
    "decimals": 6,
    "symbol": "USDC"
  },
  "chain": "eip155:8453",
  "deadline": null,
  "disclaimer": "not financial advice; you sign; ...",
  "network": "base",
  "quote": {
    "buyAmountMinRaw": "1831176287",
    "buyAmountRaw": "1840378178",
    "gasEstimate": 81662,
    "priceImpactPct": 0.02,
    "route": {
      "feeTier": 500,
      "hops": 1,
      "venue": "univ3"
    },
    "slippageBps": 50,
    "venuesCompared": [
      {
        "buyAmountRaw": "1838425629",
        "venue": "aerodrome"
      },
      {
        "buyAmountRaw": "1840378178",
        "venue": "univ3"
      }
    ]
  },
  "sellAmountRaw": "1000000000000000000",
  "sellToken": {
    "decimals": 18,
    "symbol": "WETH"
  },
  "transaction": {
    "data": "0x04e45aaf...",
    "to": "0x2626664c...",
    "value": "0"
  },
  "warnings": []
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.05.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.agentstools.dev/swap/quote?amountIn=1000000000000000000&recipient=0x1111111111111111111111111111111111111111&slippageBps=50&tokenIn=WETH&tokenOut=USDC'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.agentstools.dev/swap/quote?amountIn=1000000000000000000&recipient=0x1111111111111111111111111111111111111111&slippageBps=50&tokenIn=WETH&tokenOut=USDC' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.agentstools.dev%2Fswap%2Fquote
const res = await pay("https://api.agentstools.dev/swap/quote?amountIn=1000000000000000000&recipient=0x1111111111111111111111111111111111111111&slippageBps=50&tokenIn=WETH&tokenOut=USDC");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://api.agentstools.dev/swap/quote?amountIn=1000000000000000000&recipient=0x1111111111111111111111111111111111111111&slippageBps=50&tokenIn=WETH&tokenOut=USDC")
    print(res.status_code, res.text)

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed40283 ms$0.05
6 h agoPassed40294 ms$0.05
10 h agoPassed40223 ms$0.05
14 h agoPassed402143 ms$0.05
18 h agoPassed40277 ms$0.05
22 h agoPassed40269 ms$0.05
26 h agoPassed402129 ms$0.05
29 h agoPassed40287 ms$0.05
33 h agoPassed40227 ms$0.05
36 h agoPassed40284 ms$0.05
40 h agoPassed40224 ms$0.05
44 h agoPassed40292 ms$0.05
47 h agoPassed40227 ms$0.05
2 days agoPassed40224 ms$0.05
2 days agoPassed402101 ms$0.05