Woofi Swap

WOOFi Swap — Best-Price Meta-Aggregator (V2)

Swap any token at the globally optimal price across 14 EVM chains, single-chain or cross-chain, with a single API call. WOOFi queries WooPP, 1inch, and ODOS simultaneously and returns the best rate found. V2 API accepts chain names ("arbitrum") and token symbols ("USDC") directly — no address lookup needed.

Why Use WOOFi

• Best price guaranteed by design: Compares WooPP, 1inch, and ODOS in real time. Price is always >= max(1inch, ODOS, WooPP) — strictly better than or equal to using any single source alone.
• Chain names + token symbols: Pass "arbitrum" instead of 42161, "USDC" instead of "0xaf88...". Case-insensitive, no manual address resolution needed.
• Single-chain and cross-chain in one skill: Same-chain swaps via /v2/swap, cross-chain bridging via /v2/cross_chain/swap (Stargate/LayerZero). Both return ready-to-sign tx_steps.
• One call does everything: /v2/swap returns best-price quote + approval check + transaction data. No separate calls needed — just iterate tx_steps and sign.
• All tokens, 14 chains: Any ERC-20 and native gas token (ETH, BNB, AVAX, POL, etc.) on all supported chains. No whitelist limitation.

When to Use This Skill

Use WOOFi Swap when the user wants to:

• Swap, trade, exchange, or convert any token on any EVM chain
• Get a price quote or exchange rate between two tokens
• Find the best available price across DEX aggregators
• Bridge tokens across chains — cross-chain swap via Stargate
• Buy or sell a specific cryptocurrency
• Build a swap transaction for wallet signing and on-chain execution

---

API Endpoints

Base URL: https://sapi.woofi.com | Auth: None | Rate Limit: 5 req/s | Format: JSON

Flexible Input (all V2 endpoints)

• Chain: chain ID (42161) or name ("arbitrum") — case-insensitive, strips spaces/dashes
• Token: address ("0xaf88...") or symbol ("USDC") — resolved via local index, static manifests, alias table, and external API fallback

---

1. Get Quote — POST /v2/quote

Returns the best available price. Read-only — no transaction generated.

Response: 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. Execute Swap — POST /v2/swap

Single-call swap: quote + approval check + transaction building in one response. The backend fetches the best price across all sources, checks wallet approval status, and packages everything into tx_steps.

Response (extends quote): needs_approve, tx_steps — iterate and sign each tx in order.

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. Cross-Chain Quote — POST /v2/cross_chain/quote

Price quote for cross-chain swap via Stargate bridge. Read-only.

Response: 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. Cross-Chain Swap — POST /v2/cross_chain/swap

Build transaction(s) for cross-chain swap via Stargate bridge.

Response (extends cross-chain quote): 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"}'

---

Supported Chains

Native token: Use symbol ("ETH", "BNB", "AVAX", "POL", "MNT", "S", "BERA", "MON") or 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.

---

Important Notes

1. Best price by design — WOOFi queries WooPP + 1inch + ODOS simultaneously. Price >= max(all sources). 2. Flexible input — Chain names ("arbitrum") and token symbols ("USDC") accepted everywhere. No address lookup needed. 3. One call, full swap — /v2/swap returns quote + approval check + tx data. Just iterate tx_steps and sign. 4. Cross-chain via Stargate — /v2/cross_chain/swap bridges tokens between chains. tx_steps include LayerZero fee in value field. 5. Human-readable amounts — Pass "1.5" not wei. No unit conversion needed for input. 6. All tokens supported — Any ERC-20 or native gas token on any supported chain. No whitelist. 7. Cross-chain token resolution — src_token resolves against src_chain, dst_token against dst_chain. Same symbol maps to correct addresses on each chain. 8. Wallet signing required — API returns unsigned tx data. The user's wallet must sign and broadcast.