PaladinFi SwapのオープンクライアントおよびAPI仕様 — Base上のAIエージェント向けに最適化された、競争力のあるマルチアグリゲーター・スワップルーターです。本リポジトリには、公開RESTおよびMCP API仕様、動作するコード例、およびシンクライアントラッパーが含まれています。swap.paladinfi.comでホストされているバックエンドはプロプライエタリ（非公開）です。
ルーティングの範囲。 PaladinFi Swapは、統合された複数のアップストリームアグリゲーター（現在は0xおよびVelora。1inchおよびOdosも計画中）を並列でクエリし、手数料控除後の購入額が最も高いルートを返します。当社は、返されたルートがDeFi市場全体で利用可能な最良、最低コスト、または最適であることを保証するものではありません。「ベストエグゼキューション（最良執行）」といった表現は、米国証券法において特別な意味を持つ用語であり、意図的に使用していません。
オンチェーンスワップを実行する必要があるAIエージェントのために構築されたスワップルーターです。エージェントがツールを1回呼び出すだけで、サービスはウォレットで署名・送信可能な実行用calldataを返します：
トランザクション送信先のルーターアドレス
ルーティングがすべて組み込まれたcalldata
最小購入額（オンチェーンで強制されるスリッページ保護）
アフィリエイト手数料が組み込み済み — ユーザー側での個別の会計処理は不要
エージェントは、アグリゲーターの接続処理、スリッページ管理、手数料ロジックの実装をスキップできます。1回の呼び出しで、実行可能なバイトコードを取得します。
本サービスはノンカストディアルです。PaladinFiがユーザーの資金を保持、署名、移動することはありません。すべてのトランザクションは、ユーザー自身のウォレット（またはユーザーを代理するエージェント）によって署名および送信されます。
Related MCP server: agentfi-mcp-server
Claude CodeまたはStreamable-HTTPトランスポートをサポートするMCP互換クライアントの場合：
claude mcp add --transport http --scope user paladin-swap https://swap.paladinfi.com/mcpクライアントを再起動してください。以下の3つのツールが利用可能になります：
swap_quote(sellToken, buyToken, sellAmount, taker, chainId?, slippageBps?) — 0x + Velora間でのBest-of-Nクォート。実行可能なcalldataを返します。
trust_check_preview(address, chainId?) — トークンコントラクトの信頼性評価のサンプルプレビュー。無料/非課金。プレビューであることを明確にするため _real: false を返します。実際の評価は @paladinfi/eliza-plugin-trust または @paladinfi/agentkit-actions を通じて利用可能です（x402経由で課金、$0.001/回）。
swap_health() — ルーティングサービスの稼働状況およびソースごとのカウンター。
ツールスキーマの詳細は mcp-tools.json を参照してください。
MCPは不要です。エンドポイントを直接叩いてください：
curl -sS https://swap.paladinfi.com/v1/quote \
-H 'content-type: application/json' \
-d '{
"chainId": 8453,
"sellToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"buyToken": "0x4200000000000000000000000000000000000006",
"sellAmount": "5000000",
"taker": "0xYOUR_AGENT_WALLET"
}'RESTの完全な仕様は openapi.yaml にあります。
メソッド | パス | 目的 |
|
| 稼働状況 + 手数料設定 + ソースごとのカウンター |
|
| Best-of-Nルートクォートとcalldata (現在は0x + Velora) |
|
| 信頼性評価の無料サンプルプレビュー |
|
| MCP Streamable-HTTPトランスポート |
{
"source": "velora",
"chainId": 8453,
"router": "0x6a000f20005980200259b80c5102003040001068",
"calldata": "0x...",
"buyAmount": "2160000000000000",
"minBuyAmount": "2138000000000000",
"sellAmount": "5000000",
"gas": "318707",
"ourFeeBps": 10,
"ourFeeRecipient": "0xeA8C33d018760D034384e92D1B2a7cf0338834b4",
"estimatedOurFeeAmount": "2160000000000",
"estimatedOurFeeToken": "0x4200000000000000000000000000000000000006"
}source は、このクォートで採用されたアップストリームアグリゲーター（"0x" または "velora"）です。taker から to=router, data=calldata, value=0 (ERC20→ERC20の場合) としてトランザクションを送信してください。
examples/python/quote_and_swap.py — web3.pyを使用したPythonの例
examples/typescript/quote_and_swap.ts — viemを使用したTypeScriptの例
購入トークンに対して一律 10ベーシスポイント (0.1%) が徴収されます。手数料は見積もりではなく実際の約定額に対して計算されるため、クォートと約定の間にプールが変動しても、予想以上の手数料を支払うことはありません。
手数料は直接PaladinFiのトレジャリーに送金されるため、ユーザー側でのオンチェーン受領ステップは不要です。手数料受取先アドレスは /health で公開されており、オンチェーンで監査可能です。サービスへのクエリは無料であり、呼び出しごとの追加料金やスプレッドは発生しません。
チェーン: Base (8453)。Ethereumメインネット、Arbitrum、Optimism、BNBはロードマップに含まれています。
トークン: Base上の0xまたはVeloraがサポートするすべてのERC20。カバー範囲は両アグリゲーターの和集合です。標準的なペア（USDC, WETH, cbBTC, USDT, DAI, AERO）は両方でルーティング可能ですが、ロングテールトークンはどちらか一方のみでルーティングされることが多いです。
[x] Baseでの0x Settlerルーティング
[x] Baseでの0xとVeloraによるBest-of-Nルーティング (v0.11.66+, 2026-05-04)
[x] MCP Streamable-HTTPトランスポート
[x] trust_check_preview MCPツール (v0.11.65)
[ ] 1inch + Odosの追加ルーティングソース — 計画中
[ ] Ethereumメインネット、Arbitrum、BNB、Optimism — 計画中
[ ] Permit2ネイティブフロー (承認トランザクションをスキップ) — 計画中
本番稼働中。エンドポイントはライブであり、監視され、Base上のオンチェーンテストトランザクションでエンドツーエンドの検証済みです。現在の手数料設定、バージョン、ソースごとのカウンターについては /health を参照してください。
ファイル / フォルダ | 目的 |
本ファイル | |
MIT — 本リポジトリ内のすべてに適用 | |
公開REST API用のOpenAPI 3.0仕様 | |
MCPツールスキーマ | |
動作するコード例 (Python, TypeScript) |
本リポジトリに含まれないもの: ホストされているバックエンド（プロプライエタリ）。本リポジトリは公開クライアントインターフェースであり、インストール手順、スキーマ、統合コードサンプルを提供します。
メール: dev@paladinfi.com
マーケティング: paladinfi.com
ランディングページ: paladinfi.com/swap/
本サービスは、ミシガン州の有限責任会社である Malcontent Games LLC (商号: PaladinFi) によって運営されています。本サービスはサードパーティのアグリゲーター（現在は0xおよびVelora）を通じてクォートをルーティングします。ユーザーは資産の管理権を保持し、エージェントがすべてのトランザクションに署名します。PaladinFiがユーザーの資金を保持することはありません。
ホストされている本サービスの利用には、PaladinFi利用規約およびプライバシーポリシーが適用されます。
本リポジトリの内容は MITライセンス の下で公開されています。ホストされているバックエンドはプロプライエタリであり、対象外です。
This server cannot be deployed
Non-custodial DEX aggregator for autonomous AI agents: best-price swaps on 8 chains, no API key.
Cross-chain token swaps for autonomous agents on Base L2 and partner rails
Autonomous DeFi router for multi-hop execution, MEV risk mitigation, and transaction calldata.
Token swaps and honeypot/rug checks for AI agents on 8 chains, paid per-call in USDC via x402.
