📊 WOOFi Data
用途:拉取 WOOFi DEX 的各类链上指标,用于市场分析、报告撰写与 DeFi 研究,例如比较不同链的 DEX 活跃度、查看 WOOFi Earn 金库 TVL 与 APY、分析交易量来源、监控 WOO 质押、查询用户仓位与永续合约量。
基础信息:Base URL 为 https://api.woofi.com,无需鉴权(完全公开),速率限制 5 请求/秒。支持链:bsc、avalanche、polygon、arbitrum、optimism、linea、base、mantle、sonic、berachain、hyperevm、monad、solana、fantom、zksync、polygon_zkevm。
主要端点:/swap_support 支持的链、DEX 与代币;/multi_total_stat、/total_stat、/cumulate_stat 交易总量;/stat 按周期与链的交易量、交易者数与笔数;/source_stat 按聚合器来源(如 1inch、0x、Paraswap)拆分交易量;/token_stat 单币 24 小时数据;/solana_stat Solana 池数据;/yield 与 /earn_summary 金库 TVL 与 APY;/stakingv2 全局 WOO 质押统计;/user_balances、/user_supercharger_infos、/user_stakingv2_infos、/boosted_apr_info 用户组合;/user_trading_volumes、/user_perp_volumes 用户交易量;/woofi_pro/perps_volume 永续合约日交易量;/integration/pairs、/integration/tickers、/integration/pool_states 集成数据。
用法示例:curl "https://api.woofi.com/stat?period=1d&network=arbitrum";/stat 需 period(1d、1w、1m、3m、1y、all)与 network;用户类端点需 user 地址,period 为 7d、14d、30d。仓库提供脚本 scripts/total_volume.py(--period 1m)与 scripts/total_tvl.py。
注意事项:所有 USD 值(volume_usd、total_deposit)为 wei,须除以 10^18;链名须用精确名称(如 arbitrum 而非 arb);1m 返回 30 天日桶需自行求和;/stakingv2 为全局无 network 参数;交易者数不可跨时间桶相加;1d 返回小时桶;跨链查询需逐链请求后手动聚合,例外为 /multi_total_stat 与 /user_trading_volumes;EVM 地址需 checksummed;fantom、zksync、polygon_zkevm 在 /earn_summary 中暂停。
限制:HyperEVM、Monad 不支持 /yield;Solana 不支持 /user_* 与 /integration;具体字段与最新支持情况以官方 API 文档为准。API 文档:https://api.woofi.com/llms.txt,官方文档:https://learn.woo.org,原始技能:https://github.com/woonetwork/woofi-skills。