paladin-swap-mcp

PaladinFi SwapのオープンクライアントおよびAPI仕様 — Base上のAIエージェント向けに最適化された、競争力のあるマルチアグリゲーター・スワップルーターです。本リポジトリには、公開RESTおよびMCP API仕様、動作するコード例、およびシンクライアントラッパーが含まれています。swap.paladinfi.comでホストされているバックエンドはプロプライエタリ（非公開）です。

ルーティングの範囲。 PaladinFi Swapは、統合された複数のアップストリームアグリゲーター（現在は0xおよびVelora。1inchおよびOdosも計画中）を並列でクエリし、手数料控除後の購入額が最も高いルートを返します。当社は、返されたルートがDeFi市場全体で利用可能な最良、最低コスト、または最適であることを保証するものではありません。「ベストエグゼキューション（最良執行）」といった表現は、米国証券法において特別な意味を持つ用語であり、意図的に使用していません。

PaladinFi Swapとは？

オンチェーンスワップを実行する必要があるAIエージェントのために構築されたスワップルーターです。エージェントがツールを1回呼び出すだけで、サービスはウォレットで署名・送信可能な実行用calldataを返します：

• トランザクション送信先のルーターアドレス

• ルーティングがすべて組み込まれたcalldata

• 最小購入額（オンチェーンで強制されるスリッページ保護）

• アフィリエイト手数料が組み込み済み — ユーザー側での個別の会計処理は不要

エージェントは、アグリゲーターの接続処理、スリッページ管理、手数料ロジックの実装をスキップできます。1回の呼び出しで、実行可能なバイトコードを取得します。

本サービスはノンカストディアルです。PaladinFiがユーザーの資金を保持、署名、移動することはありません。すべてのトランザクションは、ユーザー自身のウォレット（またはユーザーを代理するエージェント）によって署名および送信されます。

インストール (MCP)

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 を参照してください。

インストール (REST)

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 にあります。

エンドポイント

レスポンス形式 (要約)

{
  "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 を参照してください。

本リポジトリの内容

本リポジトリに含まれないもの: ホストされているバックエンド（プロプライエタリ）。本リポジトリは公開クライアントインターフェースであり、インストール手順、スキーマ、統合コードサンプルを提供します。

お問い合わせ

• メール: dev@paladinfi.com

• マーケティング: paladinfi.com

• API: swap.paladinfi.com/health

• ランディングページ: paladinfi.com/swap/

法的情報

本サービスは、ミシガン州の有限責任会社である Malcontent Games LLC (商号: PaladinFi) によって運営されています。本サービスはサードパーティのアグリゲーター（現在は0xおよびVelora）を通じてクォートをルーティングします。ユーザーは資産の管理権を保持し、エージェントがすべてのトランザクションに署名します。PaladinFiがユーザーの資金を保持することはありません。

ホストされている本サービスの利用には、PaladinFi利用規約およびプライバシーポリシーが適用されます。

ライセンス

本リポジトリの内容は MITライセンス の下で公開されています。ホストされているバックエンドはプロプライエタリであり、対象外です。