13trust / 100

Swap

x402 APIFailing, checked 56 min ago

Build an unsigned swap transaction for the best route. Builds an unsigned transaction for the selected route. Compare it with a fresh quote, validate every returned transaction field, obtain explicit signing approval, and broadcast it through the selected chain's RPC. For an ERC-20 source, approve the router in tx.to for at least srcAmount before executing the returned transaction, or pass a permit or usePermit2 instead.

GET

https://api.3route.io/v1/:chainId/swap

Price: $0.00001; per call in USDC
Uptime: 0.0%; last 30 days
Response time: -; no timed checks yet
Last check: Failed; 56 min ago, next in 8 min

Run a free test call How to call it

Reliability

All checks passedSome failedAll failedNot checked

Latest check failed 56 min ago: Expected HTTP 402, got 404

Status and outage history · Atom feed · Watch with other listings

How to call it

GET https://api.3route.io/v1/:chainId/swap

Each call costs $0.00001 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.3route.io/v1/:chainId/swap?amount=1000000000000000000&dst=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fee=0&from=0x1111111111111111111111111111111111111111&gasPrice=1000000000&includeBlockNumber=false&includeProtocols=false&includeTokensInfo=false&receiver=0x1111111111111111111111111111111111111111&referrer=0x1111111111111111111111111111111111111111&slippage=1&src=0x0000000000000000000000000000000000000000&usePermit2=false

Parameters

Parameter	Type	Required	Description
`amount`	string	Yes	Positive amount of src to sell in smallest units, as an integer string.
`dst`	string	Yes	Address of the token being bought; take one from the token-list operation for the selected chain, or use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.
`excludedProtocols`	string	No
`fee`	number	No	Default: 0.
`from`	string	Yes	Address that signs and sends the transaction, and that the src tokens are taken from
`gasPrice`	string	No
`includeBlockNumber`	boolean	No	Default: false.
`includeProtocols`	boolean	No	Default: false.
`includeTokensInfo`	boolean	No	Default: false.
`permit`	string	No
`protocols`	string	No
`receiver`	string	No
`referrer`	string	No
`slippage`	number	No	Default: 1.
`src`	string	Yes	Address of the token being sold; use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.
`usePermit2`	boolean	No	Default: false.

Example response

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

{
  "dstAmount": "950000",
  "dstAmountMin": "940500",
  "gas": 210000,
  "srcAmount": "1000000000000000000",
  "tx": {
    "data": "0x1234",
    "from": "0x1111111111111111111111111111111111111111",
    "gas": "210000",
    "gasPrice": "1000000000",
    "to": "0x2222222222222222222222222222222222222222",
    "value": "1000000000000000000"
  }
}

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.001.

The code pays $0.001 in USDC on Base instead: it uses a payment scheme other than exact, which needs a different client setup.

curl: see the payment challenge

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.3route.io/v1/:chainId/swap?amount=1000000000000000000&dst=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fee=0&from=0x1111111111111111111111111111111111111111&gasPrice=1000000000&includeBlockNumber=false&includeProtocols=false&includeTokensInfo=false&receiver=0x1111111111111111111111111111111111111111&referrer=0x1111111111111111111111111111111111111111&slippage=1&src=0x0000000000000000000000000000000000000000&usePermit2=false'

# 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.3route.io/v1/:chainId/swap?amount=1000000000000000000&dst=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fee=0&from=0x1111111111111111111111111111111111111111&gasPrice=1000000000&includeBlockNumber=false&includeProtocols=false&includeTokensInfo=false&receiver=0x1111111111111111111111111111111111111111&referrer=0x1111111111111111111111111111111111111111&slippage=1&src=0x0000000000000000000000000000000000000000&usePermit2=false' \
  | 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.001 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.001" });
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.001 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.3route.io%2Fv1%2F%3AchainId%2Fswap
const res = await pay("https://api.3route.io/v1/:chainId/swap?amount=1000000000000000000&dst=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fee=0&from=0x1111111111111111111111111111111111111111&gasPrice=1000000000&includeBlockNumber=false&includeProtocols=false&includeTokensInfo=false&receiver=0x1111111111111111111111111111111111111111&referrer=0x1111111111111111111111111111111111111111&slippage=1&src=0x0000000000000000000000000000000000000000&usePermit2=false");
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.001 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.001"})
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.3route.io/v1/:chainId/swap?amount=1000000000000000000&dst=0x5fc5360d0400a0fd4f2af552add042d716f1d168&fee=0&from=0x1111111111111111111111111111111111111111&gasPrice=1000000000&includeBlockNumber=false&includeProtocols=false&includeTokensInfo=false&receiver=0x1111111111111111111111111111111111111111&referrer=0x1111111111111111111111111111111111111111&slippage=1&src=0x0000000000000000000000000000000000000000&usePermit2=false")
    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

When	Result	HTTP	Time	Price
56 min ago	Expected HTTP 402, got 404	404	88 ms	-
5 h ago	Expected HTTP 402, got 404	404	79 ms	-
10 h ago	Expected HTTP 402, got 404	404	139 ms	-
15 h ago	Expected HTTP 402, got 404	404	51 ms	-
21 h ago	Expected HTTP 402, got 404	404	62 ms	-

Show 10 older checks

27 h ago	Expected HTTP 402, got 404	404	67 ms	-
32 h ago	Expected HTTP 402, got 404	404	66 ms	-
38 h ago	Expected HTTP 402, got 404	404	53 ms	-
44 h ago	Expected HTTP 402, got 404	404	89 ms	-
2 days ago	Expected HTTP 402, got 404	404	69 ms	-
2 days ago	Expected HTTP 402, got 404	404	32 ms	-
2 days ago	Expected HTTP 402, got 404	404	96 ms	-
3 days ago	Expected HTTP 402, got 404	404	87 ms	-
3 days ago	Expected HTTP 402, got 404	404	76 ms	-
3 days ago	Expected HTTP 402, got 404	404	31 ms	-

Trust score 13/ 100

Availability (30-day uptime)		0 / 30
Valid x402 challenge		0 / 15
Response time		0 / 10
Real paying agents (30 days)		3 / 15
Charges what it lists		0 / 10
Security scan		10 / 10
Verified owner		0 / 10

How the score works

Payment terms

Price: $0.00001 per call
Listed at: $0.00001
Token: USDC
Networks: Base, eip155:42793, Solana
Pays to: 0x5D89…07Eb

Real usage

Paying agents: 1 in 30 days
Paid calls: 3 in 30 days
Last paid call: 24 days ago

Source: x402 Bazaar settlement data.

Is this your service?

Verify ownership to get the badge and 10 more trust points. Featured placement needs it too.

Verify ownership

Changed something? Check it again now and see what agents get.

Show the score

A badge for your README or docs. It updates with every check and links here.

Trust score

[![ToolVet trust score](https://toolvet.app/badge/swap-2.svg)](https://toolvet.app/s/swap-2)