WOOFi Bot 是一个围绕 WOOFi DEX 构建的完整技能，提供数据分析、兑换报价与兑换执行能力，主要面向市场分析、报告、DeFi 研究以及交易前的报价与交易构建。资料显示其版本为 v4.0.0，对齐 woonetwork/woofi-skills v1.1（2026-03-20），更新时间为 2026-03-23。
一、用途与适用场景 该技能适用于以下情形：查询特定链上的 WOOFi 交易量；比较多条链上的 DEX 活跃度；查看 WOOFi Earn 金库的 TVL 与 APY；分析交易量来源（如 1inch、0x、Paraswap 等）；监控 WOO 质押指标与 APR；查询用户投资组合数据（余额、仓位、质押）；查看 WOOFi Pro 永续合约交易量；获取代币兑换报价；查看资金池流动性与储备；追踪协议收入；构建 DeFi 仪表盘或报告。
二、API 基础信息 基础地址为 https://api.woofi.com，无需鉴权（完全公开），限速 5 请求/秒。支持的网络包括：bsc、avalanche、polygon、arbitrum、optimism、linea、base、mantle、sonic、berachain、hyperevm、monad、solana、fantom、zksync、polygon_zkevm、sei。
三、主要能力（共 17 个端点）
- 兑换支持 /swap_support：查询支持兑换的网络、DEX 与代币，返回 dexs、network_infos、token_infos，以及 swap_enable、bridge_enable 标志。注意 fantom、zksync、polygon_zkevm 等暂停网络的代币 swap_enable 均为 false。
- 兑换报价（v1）POST /v1/quote：使用新接口 sapi.woofi.com，获取代币兑换汇率与预期获得数量，不执行交易。参数包括 chain_id、sell_token、buy_token、sell_amount（必填），slippage_pct（默认 0.5）、woofi_only（默认 false）可选。返回 chain_id、sell_token、buy_token、sell_amount、buy_amount、price、guaranteed_price。原生资产（ETH、BNB 等）地址为 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE。该接口为只读报价，用于价格检查、滑点评估与交易前验证。
- 兑换执行 POST /v1/swap：同样基于 sapi.woofi.com，生成可上链的交易数据，包含必要的代币授权。参数在报价参数基础上增加 to、rebate_to（必填），slippage_pct、signer_address 可选。返回 needs_approve、tx_steps 数组、buy_amount、price、guaranteed_price。tx_steps 每项包含 to、data、value、desc。若包含多个步骤，必须严格按顺序提交（授权需先确认再执行兑换）；交易需由用户钱包签名并广播。
- 兑换报价（旧版）/swap：使用旧接口 api.woofi.com，返回路由信息、预期输出与价格影响。参数 from_token、to_token、from_amount（最小单位）、network 必填，slippage 可选（基点，默认 50）。该接口仅返回报价，不执行兑换。
- 总量统计 /multi_total_stat、/total_stat、/cumulate_stat：跨链聚合交易统计。
- 交易统计 /stat：按周期与链返回交易量、交易者数与交易笔数。period 支持 1d、1w、1m、3m、1y、all。注意 volume_usd 以 wei 为单位，需除以 10^18 得到美元值。
- 来源统计 /source_stat：按集成方/聚合器拆解交易量，返回 name、volume_usd（wei）、percentage、traders、txs。已知集成方包括 1inch、0x、ODOS、KyberSwap、Paraswap、THORSwap、OKX、BitKeep、Firebird、Transit Swap、Hera Fireance、Yeti、Joy、ZetaFarm、Slingshot、unizen、1delta、KALM、ONTO、Velora、Nativo 等。
- 代币统计 /token_stat：按链返回代币 24 小时交易统计，含 TVL、交易量与换手率。
- Solana 资金池统计 /solana_stat：Solana 专属原始资金池统计。
- Earn 收益 /yield：按链返回金库 TVL、APY 与收益构成，含 auto_compounding、total_deposit（wei）、apy、source_apy。
- Earn 汇总 /earn_summary：跨网络 Supercharger 金库 APR 汇总，按 APR 排序，暂停网络被排除。
- WOO 质押 /stakingv2：全局 WOO 质押统计，含 total_woo_staked（wei）、avg_apr、base_apr、mp_boosted_apr。
- 用户投资组合 /user_balances、/user_supercharger_infos、/user_stakingv2_infos、/boosted_apr_info：需提供 user 或 user_address（EVM 需校验和地址）。
- 用户交易量 /user_trading_volumes、/user_perp_volumes：需提供 user_address 与 period（7d、14d、30d，与 stat 端点不同）。
- WOOFi Pro 永续 /woofi_pro/perps_volume：WOOFi Pro 每日永续合约交易量。
- 集成端点 /integration/pairs、/integration/tickers、/integration/pool_states：交易对、24 小时行情与资金池状态。pool_states 返回 reserve、fee_rate（基点）、max_gamma、max_notional_swap、cap_bal、price（18 位定点）、spread。
- 协议收入 /analytics/daily_fee：按日期范围（YYYY-MM-DD）返回 WOOFi Swap 与 WOOFi Pro 的每日净协议收入拆解。
四、使用方式 所有端点通过 HTTP 调用，示例使用 curl。报价与兑换执行使用 POST 并携带 JSON 请求体，其余多为 GET 查询参数。兑换执行返回的 tx_steps 需由用户钱包按顺序签名并广播，若 needs_approve 为 true 需先执行授权交易。
五、限制与注意事项 API 无需鉴权但限速 5 请求/秒；部分网络处于暂停状态（fantom、zksync、polygon_zkevm），其代币不可兑换；volume_usd、total_deposit、total_woo_staked 等字段以 wei 为单位需换算；旧版 /swap 仅返回报价不执行交易；v1 报价为只读，不生成或执行交易；兑换执行需钱包集成，交易必须由用户签名广播。资料未提供收费、价格或平台支持范围之外的信息。