PALADINFI

Competitive swap routing for AI agents.

Multi-aggregator swap router on Base. Returns ready-to-execute calldata your agent signs and submits. MCP-native — drop into Claude Code, Cursor, or any MCP-compatible client in one line. Flat 10 bps fee, no hidden spread.

Live · Base 8453 0x Settler 10 bps fee MCP / HTTP

Install (Claude Code)

One line

claude mcp add --transport http --scope user paladin-swap https://swap.paladinfi.com/mcp

Restart Claude Code. The swap_quote and swap_health tools are now available. Same install works in any MCP-compatible client supporting Streamable-HTTP transport.

What it does

Takes {sellToken, buyToken, sellAmount, taker} on Base.
Queries upstream aggregators (0x Settler today; 1inch and Odos planned) and selects a competitive route. We do not represent any returned route as the best available across the broader DeFi market.
Returns the router address and full transaction calldata. Your agent's wallet signs and submits.
A flat 10 bps fee on the buy token is included in the calldata. No surprise spread.

REST API

If your agent doesn't speak MCP, hit the REST endpoint directly.

Method	Path	Purpose
GET	`/health`	Liveness + fee config
POST	`/v1/quote`	Competitive route quote with calldata
POST	`/mcp`	MCP Streamable-HTTP transport

Quote example

curl -sS https://swap.paladinfi.com/v1/quote \
  -H 'content-type: application/json' \
  -d '{
    "chainId": 8453,
    "sellToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "buyToken":  "0x4200000000000000000000000000000000000006",
    "sellAmount": "5000000",
    "taker": "0xYourAgentWallet"
  }'

Response shape (abridged)

{
  "source": "0x",
  "chainId": 8453,
  "router": "0x0000000000001ff3684f28c67538d4d072c22734",
  "calldata": "0x...",
  "buyAmount": "2160000000000000",
  "minBuyAmount": "2138000000000000",
  "sellAmount": "5000000",
  "gas": "318707",
  "ourFeeBps": 10,
  "ourFeeRecipient": "0xeA8C33d018760D034384e92D1B2a7cf0338834b4",
  "estimatedOurFeeAmount": "2160000000000",
  "estimatedOurFeeToken": "0x4200000000000000000000000000000000000006"
}

Submit as to=router, data=calldata, value=0 from taker.

Fees

Flat 10 basis points (0.1%) on the buy token. The fee is calculated against the actual fill amount, not the quoted estimate, so you never pay more than expected even if pool prices move between quote and fill.

Fees route directly to the Paladin Swap treasury. The recipient address is published in /health — auditable on-chain. The service stays free to query; we don't gate quotes, charge per-call, or take spread on top.

Supported assets

Chain: Base (8453). Ethereum mainnet, Arbitrum, Optimism, BNB are on the roadmap.
Tokens: Any ERC20 supported by 0x Settler on Base — USDC, WETH, cbBTC, USDT, DAI, AERO, and a long tail of mid-cap pairs.

Why this exists

Agents that swap on-chain currently glue together aggregator APIs themselves, handle slippage and fee accounting, and reinvent the same routing logic per project. PaladinFi Swap is the routing layer factored out — one tool call, ready calldata, deterministic fee. Built so agentic wallets can ship faster without holding user funds in custody.

Roadmap

0x Settler routing on Base — live
MCP Streamable-HTTP transport — live
1inch + Odos as parallel routing sources (best-of-N) — in progress
Ethereum mainnet, Arbitrum, BNB, Optimism — planned
Permit2-native flow (skip the approve tx) — planned