--- name: defi.hugen.tokyo description: defi.hugen.tokyo provides read-only metadata and analytics endpoints for DeFi infrastructure, including protocol discovery, stablecoin metrics, DEX volume history, and cross-chain bridge capability enumeration. It does not execute trades, fetch live swap quotes, or submit on-chain transactions. All data is sourced from aggregators such as DefiLlama and bridge protocol registries. host: defi.hugen.tokyo --- # defi.hugen.tokyo This host serves agents and developers that need to enumerate, validate, or research DeFi infrastructure before taking action elsewhere. It covers four distinct domains: supported blockchain networks, stablecoin supply and peg data, DeFi protocol metadata, and cross-chain bridge capabilities. It is a discovery and research layer, not an execution layer — agents must route to dedicated swap or bridge execution APIs to act on what they find here. ## When to use this host Use defi.hugen.tokyo when an agent needs to enumerate supported chains, discover DeFi protocols by category or TVL, research stablecoin supply and peg mechanics, identify available bridge protocols and their chain pair coverage, or analyze historical DEX volume for a token. Do not use this host for live swap quotes, real-time token prices, order book data, wallet balance lookups, or executing any on-chain transaction — those require a dedicated DEX aggregator or bridge execution API (e.g., a 1inch, LI.FI, or similar endpoint). Also do not use fetch-bridge-tools or fetch-defi-bridge-chains as substitutes for bridge fee estimation or route optimization; they return static capability metadata only. ## Capabilities ### Chain Enumeration Identifies which blockchain networks are available across different DeFi contexts, including general API support and bridge-specific chain metadata with RPC endpoints and relayer flags. - **`fetch-supported-chains`** — Returns the full list of blockchain networks supported by the Hugen DeFi API, including each chain's name and numeric or string ID. - **`fetch-defi-bridge-chains`** — Returns the list of blockchain networks supported by DeFi bridges, including chain IDs, chain type, native token info, RPC URLs, block explorers, multicall addresses, and relayer support flags. ### Bridge Discovery Enumerates available cross-chain bridge protocols and the specific source-to-destination chain pairs each supports, enabling route planning before requesting quotes or executing transfers. - **`fetch-bridge-tools`** — Returns a list of available cross-chain bridge protocols and their supported chain pairs, including bridge keys, names, logo URIs, and fromChainId/toChainId combinations. ### Protocol and Market Intelligence Provides DeFi protocol records with TVL, categories, and chain coverage, plus historical DEX trading volume time series for specific tokens, supporting research and liquidity analysis. - **`fetch-defi-protocols`** — Returns a JSON array of DeFi protocol records including name, category, supported chains, TVL, URLs, and metadata sourced from DefiLlama. - **`fetch-dex-volume`** — Returns historical DEX trading volume as a time series for a given token on a specified chain, with per-timestamp volume data points. ### Stablecoin Analytics Returns aggregated circulating supply, peg type, peg mechanism, and per-chain distribution data for major stablecoins, useful for monitoring peg health and cross-chain supply allocation. - **`fetch-stablecoin-metrics`** — Returns aggregated circulating supply, peg type, peg mechanism, and chain-level breakdown for DeFi stablecoins across multiple networks. ## Workflows ### Cross-Chain Bridge Route Planning *Use when an agent needs to plan a cross-chain token transfer by first confirming both the source and destination chains are supported, then identifying which bridge protocols cover that chain pair.* 1. **`fetch-defi-bridge-chains`** — Enumerate all bridge-supported chains and resolve their IDs, RPC endpoints, and relayer support flags to validate the intended source and destination chains. 2. **`fetch-bridge-tools`** — Retrieve available bridge protocols and their supported fromChainId/toChainId pairs to identify which bridges can service the validated chain pair. ### DeFi Protocol Research with Chain Validation *Use when an agent needs to discover DeFi protocols available on a specific chain and must first confirm the chain ID is recognized by the API.* 1. **`fetch-supported-chains`** — Retrieve the full list of supported chain names and IDs to validate or resolve the target chain identifier. 2. **`fetch-defi-protocols`** — Fetch DeFi protocol records and filter by the validated chain to identify relevant protocols, their categories, TVL, and associated URLs. ### Token Liquidity and Volume Assessment *Use when an agent needs to assess trading activity for a token on a specific chain, with chain ID validated before querying volume data.* 1. **`fetch-supported-chains`** — Confirm the target chain name and ID are supported before constructing the volume query. 2. **`fetch-dex-volume`** — Fetch historical DEX trading volume time series for the target token address on the validated chain to analyze liquidity and activity trends. ## Skill reference ### `fetch-supported-chains` **Hugen DeFi Supported Chains** — Returns the full list of blockchain networks supported by the Hugen DeFi API, including each chain's name and numeric or string ID. *Use when:* Use when an agent needs to enumerate available chains before constructing a DeFi request, validate a chain ID, or present the user with a list of supported networks for routing or swapping. *Not for:* Do not use to fetch RPC endpoints, token lists, or live chain status — this endpoint only returns chain names and IDs. **Returns:** Returns a JSON array of objects each containing a chain name and ID, covering 40+ networks including Ethereum, BSC, Arbitrum, Polygon, Solana, Base, Optimism, and others. **Example:** `GET https://defi.hugen.tokyo/defi/chains` --- ### `fetch-stablecoin-metrics` **Stablecoin Insights** — Returns aggregated circulating supply, peg type, peg mechanism, and chain-level breakdown for DeFi stablecoins across multiple networks. *Use when:* Use when an agent needs current or historical circulating supply figures, peg status, or chain-level distribution data for major stablecoins such as USDT, USDC, or other pegged assets. *Not for:* Do not use for real-time price feeds or swap quotes; use a DEX quote API instead. Not suitable for retrieving individual wallet balances or on-chain transaction data. **Returns:** Returns a peggedAssets array where each entry contains the stablecoin name, symbol, peg type, mechanism, global circulating supply at current/prevDay/prevWeek/prevMonth snapshots, and a chainCirculating map with per-chain supply breakdowns. **Example:** `GET https://defi.hugen.tokyo/defi/stablecoins` --- ### `fetch-bridge-tools` **BridgeForge Bridge Tools** — Returns a list of available cross-chain bridge protocols and their supported chain pairs, including bridge keys, names, logo URIs, and fromChainId/toChainId combinations. *Use when:* Use when an agent needs to discover which bridge protocols are available and which source-to-destination chain pairs each bridge supports, before selecting a route or requesting a fee estimate for a cross-chain token transfer. *Not for:* Do not use for fetching live fee estimates, slippage quotes, or executing bridge transactions — this endpoint returns static bridge capability metadata only. **Returns:** Returns a bridges array listing each protocol (e.g. cbridge, across, arbitrum) with its name, logoURI, and all supported fromChainId/toChainId pairs across major EVM networks. **Example:** `GET https://defi.hugen.tokyo/defi/bridge/tools` --- ### `fetch-defi-protocols` **DeFi Protocols Hub** — Returns a JSON array of DeFi protocol records including name, category, supported chains, TVL, URLs, and metadata sourced from DefiLlama. *Use when:* Use when an agent needs to discover or enumerate DeFi protocols with their chain coverage, TVL figures, categories (e.g. CEX, DEX, lending), and associated links for integration or research purposes. *Not for:* Do not use for real-time price feeds or token swap quotes; use a dedicated price or swap quote API instead. Not suitable for per-chain TVL time-series data. **Returns:** Returns a JSON array of protocol objects each containing id, name, category, chains list, TVL, per-chain TVL breakdown, logo URL, and 1h/1d/7d TVL change percentages. **Example:** `GET https://defi.hugen.tokyo/defi/protocols` --- ### `fetch-dex-volume` **DEX Volume Insights** — Returns historical DEX trading volume as a time series for a given token on a specified chain, with per-timestamp volume data points. *Use when:* Use when an agent needs historical or recent DEX trading volume data for a specific token address on a chain, such as to analyze volume trends, compare activity across time periods, or assess liquidity depth. *Not for:* Do not use for real-time price feeds or swap quotes; use a DEX quote API instead. Not suitable for retrieving order book depth or individual trade history. **Inputs:** - `chain` (string, required) — Blockchain network identifier to query DEX volume for. - `token_address` (string, required) — ERC-20 token contract address to retrieve DEX volume data for. **Returns:** Returns a totalDataChart array of [Unix timestamp, volume] pairs covering historical daily DEX trading volume for the specified token, spanning years of data. **Example:** `GET https://defi.hugen.tokyo/defi/dex/volume?chain=base&token_address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` --- ### `fetch-defi-bridge-chains` **DeFi Bridge Chains** — Returns the list of blockchain networks supported by DeFi bridges, including chain IDs, chain type, native token info, RPC URLs, block explorers, multicall addresses, and relayer support flags. *Use when:* Use when an agent needs to enumerate all bridge-supported chains before constructing a cross-chain transfer, validating a chain ID, resolving chain metadata (RPC endpoints, explorer URLs, native token decimals), or checking whether a chain supports relayer-based bridging. *Not for:* Do not use to fetch token lists for a specific chain or to get a bridge quote or route — use a dedicated bridge quote endpoint instead. **Returns:** Returns a 'chains' array where each element describes a supported EVM network with its chain ID, native token metadata (symbol, decimals, USD price), RPC URLs, block explorer URLs, relayer support flag, and bridge contract addresses. **Example:** `GET https://defi.hugen.tokyo/defi/bridge/chains` ---