WOOFi Swap API – LLM Integration Guide ======================================= ## Overview This document provides guidance for LLMs to interact with the WOOFi Swap API. WOOFi Swap is a decentralized exchange aggregator offering deep liquidity and competitive pricing across multiple chains. Base URL: https://api.woofi.com Authentication: None required (fully public) Rate Limit: 120 requests per minute --- ## SECTION 1: TRADING STATISTICS ### GET /stat Purpose: Retrieve trading statistics for a given time period and network. Parameters: - period (query, required): Time range - 1d — last 24 hours (hourly buckets) - 1w — last 7 days (may return only 6 days of data; use 1m for full 7-day queries) - 1m — last 30 days (daily buckets) - 3m — last 3 months (daily buckets) - 1y — last 1 year (daily buckets) - all — all-time data (daily buckets) - network (query, required): Blockchain network - bsc — BNB Smart Chain - avax — Avalanche - polygon — Polygon - arbitrum — Arbitrum One - optimism — Optimism - linea — Linea - base — Base - mantle — Mantle - sonic — Sonic - berachain — Berachain - hyperevm — HyperEVM - monad — Monad - solana — Solana Example Requests: GET https://api.woofi.com/stat?period=1d&network=arbitrum GET https://api.woofi.com/stat?period=1m&network=bsc GET https://api.woofi.com/stat?period=all&network=base Example Response: { "status": "ok", "data": [ { "id": "492229", "timestamp": "1772024400", "volume_usd": "124234640850000000000000", "traders": "29", "txs": "89", "txns": "89" } ] } Field Descriptions: - timestamp : Unix epoch (seconds) for the start of the time bucket - volume_usd : Trading volume in USD, denominated in wei (divide by 10^18 to get USD value) - traders : Number of unique trading wallets within that single time bucket. WARNING: Do NOT sum traders across multiple buckets to derive unique traders over a longer period — the same wallet can appear in multiple buckets, making the summed value misleading. - txs / txns : Number of swap transactions in the time bucket (both fields are identical) Notes for LLMs: - To compute total volume for a period: sum all volume_usd values and divide by 10^18 - To compute total txs: sum all txs values - Do NOT sum traders across buckets; use per-bucket traders only for hourly/daily activity snapshots, not for period-level unique user counts - period=1w may return only 6 days of data due to bucket boundaries; always use period=1m and filter by date range when a full 7-day window is required - To get a specific date's volume: use period=1m, filter buckets where timestamp falls within that date's UTC 00:00:00 to 23:59:59 range - To get cross-chain totals: query each network separately and aggregate - Rate limit is 120 requests per minute; when querying all 13 networks at once, batch requests or add small delays to avoid hitting the limit --- ## SECTION 2: TRADING VOLUME BY SOURCE ### GET /source_stat Purpose: Retrieve trading volume breakdown by traffic source (integrator/aggregator) for a given time period and network. Parameters: - period (query, required): Time range - 1d — last 24 hours - 1w — last 7 days - 1m — last 30 days - 3m — last 3 months - 1y — last 1 year - all — all-time data - network (query, required): Blockchain network - bsc — BNB Smart Chain - avax — Avalanche - polygon — Polygon - arbitrum — Arbitrum One - optimism — Optimism - linea — Linea - base — Base - mantle — Mantle - sonic — Sonic - berachain — Berachain - hyperevm — HyperEVM - monad — Monad Example Requests: GET https://api.woofi.com/source_stat?period=1d&network=arbitrum GET https://api.woofi.com/source_stat?period=1w&network=base GET https://api.woofi.com/source_stat?period=1m&network=bsc Example Response: { "status": "ok", "data": [ { "id": "3", "name": "OpenOcean", "volume_usd": "82198846992000000000000", "txns": 12, "percentage": 3.363419938553669 }, { "id": "99", "name": "Other", "volume_usd": "1526079366118000000000000", "txns": 1415, "percentage": 62.44425506742424 } ] } Field Descriptions: - id : Internal source identifier - name : Name of the traffic source (integrator or aggregator, e.g. "KyberSwap", "0x", "ODOS") - volume_usd : Trading volume from this source in USD, denominated in wei (divide by 10^18 to get USD value) - txns : Number of swap transactions from this source - percentage : This source's share of total volume for the given period and network (%) Notes for LLMs: - Each response covers the full period for the given network — no timestamp filtering needed - "Other" is a catch-all bucket for sources not individually listed - To get the top source by volume: find the entry with the highest volume_usd (excluding "Other") - To compute USD value: divide volume_usd by 10^18 - Rate limit is 120 requests per minute --- ## SECTION 3: EARN TVL ### GET /yield Purpose: Retrieve current TVL (Total Value Locked) and yield farming data for WOOFi Earn vaults on a given network. Parameters: - network (query, required): Blockchain network - bsc — BNB Smart Chain - avax — Avalanche - polygon — Polygon - arbitrum — Arbitrum One - optimism — Optimism - linea — Linea - base — Base - mantle — Mantle - sonic — Sonic - berachain — Berachain Example Requests: GET https://api.woofi.com/yield?network=base GET https://api.woofi.com/yield?network=arbitrum Example Response: { "status": "ok", "data": { "auto_compounding": { "0xb772122C4a37fe1754B46AB1799b909351e8Cb43": { "symbol": "ETH", "source": "woofi_super_charger_v2", "apy": 4.5799287826415735, "tvl": "104537211942693926600704", "price": 2267.2239821687, "share_price": "1090914172758238007", "decimals": 18, "loan_assets_percentage": 83.95089054785724, "loan_interest_apr": 5, "reserve_vault_assets_percentage": 16.049109452142766, "reserve_vault_apr": 1.7501056547177187, "weighted_average_apr": 4.478420899446649, "x_woo_rewards_apr": 0, "woo_rewards_apr": 6.033505588364045e-12, "reward_apr": 6.033505588364045e-12 } }, "total_deposit": "1512872344779163030257664" } } Field Descriptions: - auto_compounding : Map of vault contract address to vault data - symbol : Token symbol for this vault (e.g. "ETH", "USDC", "cbBTC") - source : Vault strategy type (e.g. "woofi_super_charger_v2") - apy : Current annual percentage yield (%) - tvl : Total value locked in this vault, denominated in token's smallest unit; divide by 10^decimals to get token amount, then multiply by price for USD value - price : Current token price in USD - decimals : Token decimal places (use this to convert tvl to token amount) - loan_assets_percentage : Percentage of assets currently deployed in lending - loan_interest_apr : Interest APR from lending (%) - reserve_vault_assets_percentage : Percentage of assets in reserve vault - reserve_vault_apr : APR from reserve vault (%) - weighted_average_apr : Blended APR across lending and reserve (%) - reward_apr : Additional reward APR from token incentives (%) - total_deposit : Total TVL across all vaults on this network, in wei (divide by 10^18 for USD value) Notes for LLMs: - To get total TVL in USD for a network: use total_deposit divided by 10^18 - To get per-vault TVL in USD: divide tvl by 10^decimals to get token amount, then multiply by price - To get cross-chain total TVL: query each supported network separately and sum all total_deposit values - Rate limit is 120 requests per minute --- ## SECTION 4: WOO STAKING ### GET /stakingv2 Purpose: Retrieve current WOO staking statistics including total staked WOO and APR breakdown. This endpoint is chain-agnostic and returns global staking data. Parameters: - None required Example Request: GET https://api.woofi.com/stakingv2 Example Response: { "status": "ok", "data": { "avg_apr": 2.945327738329302, "base_apr": 1.9756815896339195, "mp_boosted_apr": 0.9696461486953825, "total_woo_staked": "567182560788976722553288628", "woo_decimals": 18 } } Field Descriptions: - avg_apr : Current average APR for WOO stakers (%) - base_apr : Base staking APR before any boosts (%) - mp_boosted_apr : Additional APR from Multiplier Points boosting (%) - total_woo_staked : Total amount of WOO tokens staked across all chains, denominated in wei (divide by 10^woo_decimals to get WOO amount) - woo_decimals : Decimal places for WOO token (18) Notes for LLMs: - To get total staked WOO amount: divide total_woo_staked by 10^18 - avg_apr = base_apr + mp_boosted_apr - This endpoint returns global data across all chains; no network parameter is needed - Rate limit is 120 requests per minute --- ## Usage Examples Q: What is WOOFi Swap's trading volume on Arbitrum in the last 24 hours? 1. Call GET https://api.woofi.com/stat?period=1d&network=arbitrum 2. Sum all volume_usd values, divide by 10^18 3. Report the result in USD Q: How many swaps were made on WOOFi on BSC last week? 1. Call GET https://api.woofi.com/stat?period=1m&network=bsc 2. Filter buckets to the last 7 days by UTC timestamp 3. Sum all txs values 4. Report the result Q: What is WOOFi's all-time trading volume on Base? 1. Call GET https://api.woofi.com/stat?period=all&network=base 2. Sum all volume_usd values, divide by 10^18 3. Report the result in USD Q: What is WOOFi's total volume across all chains last 7 days? 1. Call /stat?period=1m for each supported network: bsc, avax, polygon, arbitrum, optimism, linea, base, mantle, sonic, berachain, hyperevm, monad, solana 2. Filter buckets to the last 7 days by UTC timestamp range 3. Sum all volume_usd values across all filtered results, divide by 10^18 4. Report the combined total in USD Q: Which source drove the most volume on WOOFi Arbitrum today? 1. Call GET https://api.woofi.com/source_stat?period=1d&network=arbitrum 2. Find the entry with the highest volume_usd (excluding "Other") 3. Divide volume_usd by 10^18 and report the source name, volume, and percentage Q: What percentage of WOOFi's volume on Base came from 0x last month? 1. Call GET https://api.woofi.com/source_stat?period=1m&network=base 2. Find the entry where name is "0x" 3. Report the percentage field directly Q: What is WOOFi Earn's total TVL on Base? 1. Call GET https://api.woofi.com/yield?network=base 2. Take total_deposit from the response, divide by 10^18 3. Report the result in USD Q: What is WOOFi Earn's total TVL across all chains? 1. Call /yield?network= for each supported network: bsc, avax, polygon, arbitrum, optimism, linea, base, mantle, sonic, berachain 2. Sum all total_deposit values, divide by 10^18 3. Report the combined total in USD Q: How much WOO is currently staked on WOOFi? 1. Call GET https://api.woofi.com/stakingv2 2. Take total_woo_staked, divide by 10^18 3. Report the result in WOO Q: What is the current WOO staking APR? 1. Call GET https://api.woofi.com/stakingv2 2. Report avg_apr as the current staking APR 3. Optionally break down into base_apr and mp_boosted_apr