woofi-swap

WOOFi Swap — ベストプライスメタアグリゲーター (V2)

14 の EVM チェーンにわたって、シングルチェーンまたはクロスチェーンで、単一の API 呼び出しにより、あらゆるトークンをグローバルに最適な価格でスワップできます。WOOFi は WooPP、1inch、ODOS を同時にクエリし、見つかった最良のレートを返します。V2 API は チェーン名 ("arbitrum") と トークンシンボル ("USDC") を直接受け付けます — アドレスの検索は不要です。

WOOFi を使う理由

• 設計によるベストプライス保証: WooPP、1inch、ODOS をリアルタイムで比較します。価格は常に >= max(1inch, ODOS, WooPP) となり、単一のソースを単独で使用する場合よりも厳密に優れているか、同等です。
• チェーン名 + トークンシンボル: 42161 の代わりに "arbitrum"、"0xaf88..." の代わりに "USDC" を渡せます。大文字と小文字は区別されず、手動でのアドレス解決は不要です。
• シングルチェーンとクロスチェーンを 1 つのスキルで: 同一チェーンでのスワップは /v2/swap、クロスチェーンのブリッジは /v2/cross_chain/swap (Stargate/LayerZero) を介して行います。どちらも署名可能な tx_steps を返します。
• 1 回の呼び出しですべて完了: /v2/swap はベストプライスの見積もり + 承認チェック + トランザクションデータを返します。個別の呼び出しは不要です — tx_steps を順に処理して署名するだけです。
• すべてのトークン、14 チェーン: サポートされているすべてのチェーン上の任意の ERC-20 およびネイティブガストークン (ETH、BNB、AVAX、POL など)。ホワイトリストの制限はありません。

このスキルを使うタイミング

WOOFi Swap は、ユーザーが次のことを望む場合に使用します:

• 任意の EVM チェーン上で任意のトークンをスワップ、取引、交換、または変換する
• 2 つのトークン間の価格見積もりまたは為替レートを取得する
• DEX アグリゲーター全体で利用可能な最良の価格を見つける
• チェーンをまたいでトークンをブリッジする — Stargate を介したクロスチェーンスワップ
• 特定の暗号通貨を売買する
• ウォレット署名とオンチェーン実行用のスワップトランザクションを構築する

---

API エンドポイント

ベース URL: https://sapi.woofi.com | 認証: なし | レート制限: 5 req/s | フォーマット: JSON

柔軟な入力 (すべての V2 エンドポイント)

• チェーン: チェーン ID (42161) または名前 ("arbitrum") — 大文字と小文字は区別されず、スペース/ダッシュは除去されます
• トークン: アドレス ("0xaf88...") またはシンボル ("USDC") — ローカルインデックス、静的マニフェスト、エイリアステーブル、および外部 API フォールバックを介して解決されます

---

1. 見積もりを取得 — POST /v2/quote

利用可能な最良の価格を返します。読み取り専用 — トランザクションは生成されません。

パラメーター	型	必須	デフォルト	説明
chain	int | str	はい	—	チェーン ID または名前
sell_token	str	はい	—	トークンのアドレスまたはシンボル
buy_token	str	はい	—	トークンのアドレスまたはシンボル
sell_amount	str	はい	—	人間が読める形式の量 (例: "1000")
slippage_pct	float	いいえ	0.5	最大スリッページ %

レスポンス: chain、sell_token、buy_token、sell_amount、buy_amount、price、guaranteed_price

curl -X POST "https://sapi.woofi.com/v2/quote" \
  -H "Content-Type: application/json" \
  -d '{"chain": "arbitrum", "sell_token": "USDC", "buy_token": "WETH", "sell_amount": "1000"}'

---

2. スワップを実行 — POST /v2/swap

単一呼び出しスワップ: 見積もり + 承認チェック + トランザクション構築を 1 つのレスポンスで行います。バックエンドがすべてのソースから最良の価格を取得し、ウォレットの承認ステータスを確認し、すべてを tx_steps にパッケージ化します。

パラメーター	型	必須	デフォルト	説明
chain	int | str	はい	—	チェーン ID または名前
sell_token	str	はい	—	トークンのアドレスまたはシンボル
buy_token	str	はい	—	トークンのアドレスまたはシンボル
sell_amount	str	はい	—	人間が読める形式の量
to	str	はい	—	受取ウォレットアドレス
rebate_to	str	はい	—	リベートアドレス (通常は to と同じ)
slippage_pct	float	いいえ	0.5	最大スリッページ %
signer_address	str	いいえ	null	ウォレットアドレス (承認チェック用)

レスポンス (見積もりを拡張): needs_approve、tx_steps — 順に各トランザクションを処理して署名します。

curl -X POST "https://sapi.woofi.com/v2/swap" \
  -H "Content-Type: application/json" \
  -d '{"chain": "arbitrum", "sell_token": "USDC", "buy_token": "WETH", "sell_amount": "1000", "to": "0xYourWallet", "rebate_to": "0xYourWallet", "signer_address": "0xYourWallet"}'

---

3. クロスチェーン見積もり — POST /v2/cross_chain/quote

Stargate ブリッジ経由のクロスチェーンスワップの見積もりです。読み取り専用です。

パラメータ	型	必須	デフォルト	説明
src_chain	int | str	はい	—	ソースチェーンの ID または名前
dst_chain	int | str	はい	—	宛先チェーンの ID または名前
src_token	str	はい	—	ソーストークン（src_chain に対して解決されます）
dst_token	str	はい	—	宛先トークン（dst_chain に対して解決されます）
src_amount	str	はい	—	人間が読みやすい形式の金額
slippage_pct	float	いいえ	1.0	スリッページ許容値 %

レスポンス: src_chain、dst_chain、src_amount、dst_amount、bridge_amount_in、bridge_amount_out、price_f

curl -X POST "https://sapi.woofi.com/v2/cross_chain/quote" \
  -H "Content-Type: application/json" \
  -d '{"src_chain": "arbitrum", "dst_chain": "base", "src_token": "USDC", "dst_token": "USDC", "src_amount": "100"}'

---

4. クロスチェーンスワップ — POST /v2/cross_chain/swap

Stargate ブリッジ経由のクロスチェーンスワップ用のトランザクションを構築します。

パラメータ	型	必須	デフォルト	説明
src_chain	int | str	はい	—	ソースチェーンの ID または名前
dst_chain	int | str	はい	—	宛先チェーンの ID または名前
src_token	str	はい	—	ソーストークン（src_chain に対して解決されます）
dst_token	str	はい	—	宛先トークン（dst_chain に対して解決されます）
src_amount	str	はい	—	人間が読みやすい形式の金額
to	str	はい	—	宛先チェーン上の受取人
slippage_pct	float	いいえ	1.0	スリッページ許容値 %
signer_address	str	いいえ	null	署名者アドレス（承認チェック用）

レスポンス（クロスチェーン見積もりを拡張）: native_fee、needs_approve、tx_steps

curl -X POST "https://sapi.woofi.com/v2/cross_chain/swap" \
  -H "Content-Type: application/json" \
  -d '{"src_chain": "arbitrum", "dst_chain": "base", "src_token": "USDC", "dst_token": "USDC", "src_amount": "100", "to": "0xYourWallet", "signer_address": "0xYourWallet"}'

---

対応チェーン

チェーン	ID	ネイティブトークン	受け付ける名前
Arbitrum	42161	ETH	arbitrum, arb, arbitrumone
Base	8453	ETH	base
BSC	56	BNB	bsc, bnb, binance, bnbchain
Polygon	137	POL	polygon, matic, pol
Optimism	10	ETH	optimism, op
Avalanche	43114	AVAX	avalanche, avax
Ethereum	1	ETH	ethereum, eth, mainnet
Linea	59144	ETH	linea
Mantle	5000	MNT	mantle
Sonic	146	S	sonic
Berachain	80094	BERA	berachain, bera
HyperEVM	999	HYPE	hyperevm, hyper
Monad	143	MON	monad
zkSync	324	ETH	zksync, zksyncera

ネイティブトークン: シンボル（"ETH"、"BNB"、"AVAX"、"POL"、"MNT"、"S"、"BERA"、"MON"）または 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE を使用してください。

---

重要な注意事項

1. 設計による最良価格 — WOOFi は WooPP + 1inch + ODOS に同時にクエリを実行します。価格 >= max(すべてのソース)。
2. 柔軟な入力 — チェーン名（"arbitrum"）とトークンシンボル（"USDC"）をどこでも受け付けます。アドレスの検索は不要です。
3. 1 回の呼び出しで完全なスワップ — /v2/swap は見積もり + 承認チェック + トランザクションデータを返します。tx_steps を反復処理して署名するだけです。
4. Stargate 経由のクロスチェーン — /v2/cross_chain/swap はチェーン間でトークンをブリッジします。tx_steps には value フィールドに LayerZero 手数料が含まれます。
5. 人間が読みやすい形式の金額 — wei ではなく "1.5" を渡してください。入力に単位変換は不要です。
6. すべてのトークンに対応 — 対応する任意のチェーン上の任意の ERC-20 またはネイティブガストークン。ホワイトリストはありません。
7. クロスチェーンのトークン解決 — src_token は src_chain に対して、dst_token は dst_chain に対して解決されます。同じシンボルが各チェーン上の正しいアドレスにマッピングされます。
8. ウォレットによる署名が必要 — API は署名されていないトランザクションデータを返します。ユーザーのウォレットが署名してブロードキャストする必要があります。