Check whether an approved Base token swap is eligible before supplying a wallet
Check whether an approved Base token swap is eligible before supplying a wallet. Returns verified token contracts, indicative output, liquidity sources, fee estimate, warnings, and the exact next action. No custody, signing, or execution.
1000 (raw units)
price
2
calls / 30d
2
unique payers
2026-09-17
updated
Provider
api.usesaferoute.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x08a6a2ddecdebdbfcb29d725042a6f3d74849e08",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "1000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"amount": "25",
"from": "USDC",
"intentId": "intent_unique_1234567890",
"sourceAgentId": "buyer-agent-id",
"to": "WETH"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"allowance": {
"status": "wallet_required_for_check"
},
"amount": {
"human": "25",
"raw": "25000000",
"usdcEquivalentRaw": "25000000"
},
"chainId": 8453,
"checkId": "00000000-0000-4000-8000-000000000000",
"createdAt": "2026-01-01T00:00:00.000Z",
"estimatedOutput": {
"raw": "10000000000000000"
},
"expectedSafeRouteFee": {
"amountRaw": "12500",
"bps": 10,
"indicative": true,
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"expiresAt": "2026-01-01T00:01:00.000Z",
"liquidity": {
"available": true,
"sources": [
"Uniswap_V3"
]
},
"nextAction": {
"endpoint": "https://api.usesaferoute.com/v1/quote",
"method": "POST",
"price": "$0.01",
"requiredAdditionalField": "wallet"
},
"pair": {
"buyToken": "0x4200000000000000000000000000000000000006",
"from": "USDC",
"sellToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"to": "WETH"
},
"priceImpact": {
"status": "checked_on_full_quote",
"warning": "Price impact is calculated on the full wallet-bound quote."
},
"status": "eligible",
"tokenVerification": {
"buyTokenApproved": true,
"buyTokenDecimals": 18,
"sellTokenApproved": true,
"sellTokenDecimals": 6
},
"warnings": [
"Indicative preflight only; output and route are refreshed before a full quote."
]
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Human-readable sell amount, capped at $500 USDC equivalent",
"pattern": "^\\d+(?:\\.\\d+)?$",
"type": "string"
},
"from": {
"description": "Approved Base sell-token symbol",
"enum": [
"USDC",
"WETH",
"EURC",
"CBETH",
"CBBTC",
"VIRTUAL",
"AERO"
],
"type": "string"
},
"intentId": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"referralCode": {
"maxLength": 64,
"minLength": 3,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"sourceAgentId": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"to": {
"description": "Approved Base buy-token symbol; must differ from from",
"enum": [
"USDC",
"WETH",
"EURC",
"CBETH",
"CBBTC",
"VIRTUAL",
"AERO"
],
"type": "string"
}
},
"required": [
"from",
"to",
"amount"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"allowance": {
"properties": {
"status": {
"const": "wallet_required_for_check",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"amount": {
"properties": {
"human": {
"type": "string"
},
"raw": {
"pattern": "^\\d+$",
"type": "string"
},
"usdcEquivalentRaw": {
"pattern": "^\\d+$",
"type": "string"
}
},
"required": [
"human",
"raw",
"usdcEquivalentRaw"
],
"type": "object"
},
"attribution": {
"additionalProperties": false,
"properties": {
"intentId": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"referralCode": {
"maxLength": 64,
"minLength": 3,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"sourceAgentId": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"chainId": {
"const": 8453,
"type": "integer"
},
"checkId": {
"format": "uuid",
"type": "string"
},
"createdAt": {
"format": "date-time",
"type": "string"
},
"estimatedOutput": {
"properties": {
"minimumRaw": {
"pattern": "^\\d+$",
"type": "string"
},
"raw": {
"pattern": "^\\d+$",
"type": "string"
}
},
"required": [
"raw"
],
"type": "object"
},
"expectedSafeRouteFee": {
"properties": {
"amountRaw": {
"pattern": "^\\d+$",
"type": "string"
},
"bps": {
"const": 10,
"type": "integer"
},
"indicative": {
"const": true,
"type": "boolean"
},
"token": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
}
},
"required": [
"bps",
"amountRaw",
"token",
"indicative"
],
"type": "object"
},
"expiresAt": {
"format": "date-time",
"type": "string"
},
"liquidity": {
"properties": {
"available": {
"const": true,
"type": "boolean"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"available",
"sources"
],
"type": "object"
},
"nextAction": {
"properties": {
"endpoint": {
"format": "uri",
"type": "string"
},
"method": {
"const": "POST",
"type": "string"
},
"price": {
"const": "$0.01",
"type": "string"
},
"requiredAdditionalField": {
"const": "wallet",
"type": "string"
}
},
"required": [
"method",
"endpoint",
"price",
"requiredAdditionalField"
],
"type": "object"
},
"pair": {
"properties": {
"buyToken": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"from": {
"enum": [
"USDC",
"WETH",
"EURC",
"CBETH",
"CBBTC",
"VIRTUAL",
"AERO"
],
"type": "string"
},
"sellToken": {
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
},
"to": {
"enum": [
"USDC",
"WETH",
"EURC",
"CBETH",
"CBBTC",
"VIRTUAL",
"AERO"
],
"type": "string"
}
},
"required": [
"from",
"to",
"sellToken",
"buyToken"
],
"type": "object"
},
"priceImpact": {
"properties": {
"status": {
"const": "checked_on_full_quote",
"type": "string"
},
"warning": {
"type": "string"
}
},
"required": [
"status",
"warning"
],
"type": "object"
},
"status": {
"const": "eligible",
"type": "string"
},
"tokenVerification": {
"properties": {
"buyTokenApproved": {
"const": true,
"type": "boolean"
},
"buyTokenDecimals": {
"minimum": 0,
"type": "integer"
},
"sellTokenApproved": {
"const": true,
"type": "boolean"
},
"sellTokenDecimals": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"sellTokenApproved",
"buyTokenApproved",
"sellTokenDecimals",
"buyTokenDecimals"
],
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"checkId",
"status",
"chainId",
"createdAt",
"expiresAt",
"pair",
"amount",
"estimatedOutput",
"tokenVerification",
"liquidity",
"priceImpact",
"allowance",
"expectedSafeRouteFee",
"warnings",
"nextAction"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"payment-identifier": {
"info": {
"required": false
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"required"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.usesaferoute.com/v1/swap-safety-check" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.usesaferoute.com/v1/swap-safety-check");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.usesaferoute.com/v1/swap-safety-check")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/7489.json, and this resource appears in /discovery/resources and /discovery/search.