--- name: defi-dx.hugen.tokyo description: defi-dx.hugen.tokyo provides static and historical DeFi data including protocol catalogs with TVL, supported blockchain network listings, stablecoin directory snapshots, and historical DEX trading volume time-series. All endpoints return reference or historical data; no real-time price feeds, swap execution, or live order book data are available. host: defi-dx.hugen.tokyo --- # defi-dx.hugen.tokyo This host serves agents and tools that need structured DeFi reference data for analysis, research, or UI population. It covers three distinct data types: protocol-level metadata (TVL, categories, chains), stablecoin fundamentals (supply, peg type, chain circulation), and historical DEX volume for specific tokens. It is not a trading or pricing host — it is a data catalog and historical analytics host suited for background research and context-building tasks. ## When to use this host Use this host when an agent needs DeFi protocol metadata (TVL, categories, logos), a list of supported blockchain networks, stablecoin supply and peg data, or historical daily DEX volume for a specific token. Do not use this host for real-time price feeds, live token swap quotes, order book data, gas price lookups, or per-chain TVL breakdowns of a single protocol — use a dedicated DEX aggregator or price oracle API (e.g. 1inch, CoinGecko, or a chain-specific RPC) for those needs. This host is best suited for background research, data enrichment, and analytical workflows rather than latency-sensitive trading or execution tasks. ## Capabilities ### Network and Protocol Reference Provides the foundational catalog data needed before constructing any DeFi query: which chains are supported and which protocols exist across those chains, including TVL, categories, and metadata. - **`fetch-defi-supported-chains`** — Returns the full list of blockchain networks supported by the DeFi-DX endpoint, each with a human-readable name and chain ID. - **`fetch-defi-protocols`** — Returns a full catalog of DeFi and CEX protocols with TVL, chain coverage, category, logo, and metadata for each listed protocol. ### Stablecoin Intelligence Returns a comprehensive directory of stablecoins with circulating supply history, peg mechanisms, backing types, and per-chain circulation breakdowns for DeFi analysis or portfolio tooling. - **`fetch-stablecoin-directory`** — Returns a comprehensive list of stablecoins with circulating supply, peg type, backing mechanism, and per-chain circulation breakdowns across supported networks. ### DEX Volume Analytics Retrieves historical daily DEX trading volume as a time-series for a specific token on a specific chain, enabling trend analysis, charting, and liquidity research. - **`fetch-dex-volume`** — Returns historical daily DEX trading volume for a given token on a specified chain, as a time-series array of Unix timestamp and volume pairs. ## Workflows ### Chain-Validated DEX Volume Lookup *Use when an agent needs to fetch DEX volume for a token but must first confirm the target chain is supported by the endpoint before constructing the query.* 1. **`fetch-defi-supported-chains`** — Enumerate all supported chains and validate that the user-supplied or inferred chain name/ID is present before proceeding. 2. **`fetch-dex-volume`** — Fetch historical daily DEX volume for the target token address on the confirmed supported chain. ### Protocol Landscape with Chain Context *Use when an agent needs to present or filter the full DeFi protocol catalog alongside the list of supported chains, for example to build a chain-filtered protocol browser or cross-reference protocol chain coverage.* 1. **`fetch-defi-supported-chains`** — Retrieve the canonical list of supported chains to use as filter options or validation reference. 2. **`fetch-defi-protocols`** — Retrieve the full protocol catalog and cross-reference or filter entries against the confirmed chain list. ## Skill reference ### `fetch-defi-protocols` **DeFi Protocols Explorer** — Returns a full catalog of DeFi and CEX protocols with TVL, chain coverage, category, logo, and metadata for each listed protocol. *Use when:* Use when an agent needs a comprehensive list of DeFi or CEX protocols including their TVL figures, supported chains, categories, logos, and external links for analysis, filtering, or display purposes. *Not for:* Do not use for real-time price feeds or token swap quotes; use a dedicated price or DEX quote API instead. Not suitable for per-chain TVL breakdowns of a single protocol — this returns aggregate catalog data. **Returns:** Returns a JSON array of protocol objects each containing id, name, category, chains, TVL, per-chain TVL breakdown, logo URL, description, and 1h/1d/7d TVL change percentages. **Example:** `GET https://defi-dx.hugen.tokyo/defi/protocols` --- ### `fetch-defi-supported-chains` **DeFi Chains Lookup** — Returns the full list of blockchain networks supported by the DeFi-DX endpoint, each with a human-readable name and chain ID. *Use when:* Use when an agent needs to enumerate available chains before constructing a DeFi query, validating a user-supplied chain, or presenting chain selection options to a user. *Not for:* Do not use to fetch real-time chain status, gas prices, or token lists; use dedicated chain-health or token-list endpoints instead. **Returns:** Returns a JSON array of objects, each with a 'name' (e.g. 'Ethereum') and 'id' (e.g. '1'), covering 40+ EVM and non-EVM chains including Solana, Tron, Base, Arbitrum, and others. **Example:** `GET https://defi-dx.hugen.tokyo/defi/chains` --- ### `fetch-stablecoin-directory` **Stablecoin Directory** — Returns a comprehensive list of stablecoins with circulating supply, peg type, backing mechanism, and per-chain circulation breakdowns across supported networks. *Use when:* Use when an agent needs a full index of stablecoins including their circulating supply (current, previous day/week/month), peg mechanism (fiat-backed, crypto-backed, etc.), and chain-level circulation data for DeFi analysis or portfolio tooling. *Not for:* Do not use for real-time price streaming or swap execution; this is a static directory snapshot, not a live price feed or trading endpoint. **Returns:** Returns a peggedAssets array where each entry contains the stablecoin name, symbol, peg type, backing mechanism, global circulating supply (current and historical), and per-chain circulation breakdowns across dozens of networks. **Example:** `GET https://defi-dx.hugen.tokyo/defi/stablecoins` --- ### `fetch-dex-volume` **DEX Volume Tracker** — Returns historical daily DEX trading volume for a given token on a specified chain, as a time-series array of Unix timestamp and volume pairs. *Use when:* Use when an agent needs historical decentralized exchange volume data for a specific token contract address on a supported chain (e.g. Base), such as for charting, trend analysis, or liquidity research. *Not for:* Do not use for real-time streaming price feeds or order book data; this endpoint returns historical daily volume snapshots only. **Inputs:** - `chain` (string, required) — The blockchain network to query (e.g. 'base'). - `token_address` (string, required) — The token contract address to retrieve DEX volume data for. **Returns:** Returns a totalDataChart array of [Unix timestamp, daily volume] pairs covering historical DEX trading activity for the specified token, with per-DEX breakdown data also present. **Example:** `GET https://defi-dx.hugen.tokyo/defi/dex/volume?chain=base&token_address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` ---