--- name: eltociear-tokenguard.hf.space description: eltociear-tokenguard.hf.space is a multi-purpose data API host providing fiat currency exchange rates, weather forecasts, IP geolocation, DeFi protocol metrics, and historical crypto hack records. It aggregates data from ECB, Open-Meteo, DeFiLlama, and IP geolocation sources into discrete point-in-time query endpoints. Each skill returns a structured snapshot; none offer streaming or real-time push data. host: eltociear-tokenguard.hf.space --- # eltociear-tokenguard.hf.space TokenGuard is a general-purpose utility host that bundles several unrelated data lookup capabilities under one endpoint. It serves agents that need lightweight, on-demand data retrieval across financial, geographic, and blockchain-security domains without integrating multiple specialized providers. Its DeFi coverage is sourced from DeFiLlama, FX rates from ECB, and weather from Open-Meteo, making it a convenience aggregator rather than a deep specialist in any single domain. ## When to use this host Use this host when an agent needs quick, single-call lookups across fiat FX rates, weather, IP geolocation, or DeFi protocol metrics and does not require streaming, real-time alerts, or bulk batch queries. For deep DeFi analytics beyond TVL and hack history (e.g. token prices, swap quotes, liquidity pool data), use a dedicated DeFi data provider such as a direct DeFiLlama API or a DEX aggregator. For severe weather alerts or radar imagery, use a specialized meteorological service. For bulk IP resolution across many addresses in one call, use a dedicated IP intelligence platform. This host is not suitable for crypto-to-crypto FX conversions, live security threat feeds, or any use case requiring continuous data refresh. ## Capabilities ### Fiat Currency Conversion Provides point-in-time ECB-sourced exchange rate quotes and converted amounts for fiat currency pairs. Useful for any agent that needs to express a monetary amount in one or more target currencies. - **`fetch-fx-quote`** — Returns exchange rates and converted amounts for a base currency against one or more target symbols, with source and date metadata. ### DeFi Protocol Intelligence Retrieves DeFi protocol metadata, TVL, chain distribution, staking and borrowing figures, and optional 30-day TVL history, plus a ranked historical record of crypto hacks and exploits with loss and technique details. - **`fetch-defi-protocol-data`** — Returns DeFi protocol metadata and key metrics for a given protocol slug, including TVL, chain distribution, staking, borrowing, and optional 30-day TVL history, sourced from DeFiLlama. - **`fetch-defi-hacks`** — Returns a ranked list of major crypto hacks and exploits from DeFiLlama, filterable by minimum USD loss and result count, with classification, chain, technique, and recovered funds per incident. ### Location and Context Resolution Resolves a named location to weather conditions and forecasts, or resolves an IP address to its geographic and network identity. Together these skills let an agent establish physical context from either a place name or a network identifier. - **`fetch-weather-forecast`** — Returns current weather conditions and a multi-day forecast for a given location using Open-Meteo data, including coordinates, timezone, temperature, humidity, wind, and precipitation. - **`lookup-ip-geolocation`** — Returns geolocation and network metadata for a given IP address, including country, region, city, ASN, ISP, and timezone. ## Workflows ### IP-to-Weather Context *Use when an agent needs to determine weather conditions for a user or request identified only by IP address, without a known location name.* 1. **`lookup-ip-geolocation`** — Resolve the IP address to a city and region to obtain a human-readable location string. 2. **`fetch-weather-forecast`** — Pass the resolved city/region as the location input to retrieve current conditions and forecast for that IP's physical location. ### DeFi Protocol Risk Assessment *Use when an agent needs to evaluate a DeFi protocol's current standing alongside the broader historical exploit landscape to inform a risk or due-diligence summary.* 1. **`fetch-defi-protocol-data`** — Retrieve the protocol's TVL, chain distribution, category, and 30-day TVL history to establish its current scale and activity. 2. **`fetch-defi-hacks`** — Retrieve historical hack records filtered by a meaningful minimum loss threshold to contextualize the protocol's category and chain against known exploit patterns. ## Skill reference ### `fetch-fx-quote` **TokenGuard FX Quote** — Returns exchange rates and converted amounts for a base currency against one or more target symbols, with source and date metadata. *Use when:* Use when an agent needs a point-in-time currency conversion quote — e.g. converting USD to JPY, EUR, and GBP — including the converted amounts and rate freshness metadata. *Not for:* Do not use for real-time streaming FX rates or crypto-to-crypto conversions; this returns a single ECB-sourced snapshot quote for fiat currencies only. **Inputs:** - `base` (string, required) — ISO 4217 base currency code to convert from. - `amount` (number, required) — Numeric amount in the base currency to convert. - `symbols` (string, required) — Comma-separated list of ISO 4217 target currency codes to convert into. **Returns:** Returns base currency, input amount, as_of date, source attribution, count of symbols, a rates map with per-unit exchange rates, and a converted map with final converted amounts. **Example:** `{"base": "USD", "amount": 100, "symbols": "JPY,EUR,GBP"}` --- ### `fetch-weather-forecast` **Weather Forecast API** — Returns current weather conditions and a multi-day forecast for a given location using Open-Meteo data, including coordinates, timezone, temperature, humidity, wind, and precipitation. *Use when:* Use when an agent needs current weather conditions or a short-term daily forecast for a named location, including temperature, humidity, wind speed, precipitation, and sky condition. *Not for:* Do not use for historical weather data, severe weather alerts, or real-time radar imagery; use a dedicated meteorological service for those needs. **Inputs:** - `location` (string, required) — Name of the city or location to retrieve weather for. - `forecast_days` (integer) — Number of forecast days to return. Defaults to a short-term window; tested with up to 3 days. **Returns:** Returns a JSON object with resolved coordinates, timezone, current conditions (temperature, humidity, wind, precipitation), and an array of daily forecasts for the requested number of days. **Example:** `{"location": "Tokyo", "forecast_days": 3}` --- ### `lookup-ip-geolocation` **IP Geolocation Lookup** — Returns geolocation and network metadata for a given IP address, including country, region, city, ASN, ISP, and timezone. *Use when:* Use when an agent needs to resolve an IP address to its physical location (country, region, city, coordinates) or network identity (ASN, ISP, organization) for routing, fraud detection, analytics, or display purposes. *Not for:* Do not use for bulk IP lookups in a single call; this endpoint resolves one IP per request. Not suitable for real-time streaming or continuous IP monitoring. **Inputs:** - `ip` (string, required) — The IPv4 or IPv6 address to look up. **Returns:** Returns a JSON object with the IP's country, region, city, postal code, latitude/longitude, timezone, UTC offset, ASN, ISP, organization, EU membership flag, and source attribution. **Example:** `{"ip": "8.8.8.8"}` --- ### `fetch-defi-protocol-data` **TokenGuard DeFi Protocol Data** — Returns DeFi protocol metadata and key metrics for a given protocol slug, including TVL, chain distribution, staking, borrowing, and optional 30-day TVL history, sourced from DeFiLlama. *Use when:* Use when an agent needs current TVL, chain breakdown, staking, or borrowing figures for a named DeFi protocol (e.g. Aave, Uniswap) identified by its DeFiLlama slug. *Not for:* Do not use for token price lookups, swap quotes, or cross-chain bridge data; use dedicated price or bridge endpoints instead. **Inputs:** - `slug` (string, required) — DeFiLlama protocol slug identifying the protocol to query (lowercase, hyphenated). - `include_history` (boolean) — When true, populates the tvl_history_30d array with 30-day historical TVL data points. Defaults to false. **Returns:** Returns a protocol object for Aave with name, symbol, description, 23-chain list, total TVL of $14.2B, top-10 chains by TVL, staking ($201M), borrowed ($10.6B), social links, and an empty tvl_history_30d array. **Example:** `{"slug": "aave", "include_history": false}` --- ### `fetch-defi-hacks` **DeFiLlama Hacks** — Returns a ranked list of major crypto hacks and exploits from DeFiLlama, filterable by minimum USD loss and result count, with classification, chain, technique, and recovered funds per incident. *Use when:* Use when an agent needs historical data on crypto hacks or exploits, including total losses, attack techniques, affected chains, and recovered funds, optionally filtered by minimum loss threshold or capped to a specific number of results. *Not for:* Do not use for real-time security alerts or live exploit monitoring; this returns historical hack records, not streaming threat feeds. **Inputs:** - `limit` (integer) — Maximum number of hack records to return in the response. - `min_amount_usd` (number) — Minimum USD loss threshold; only hacks with losses at or above this value are included. **Returns:** Returns total_hacks, filtered_count, total_lost_usd, and a hacks array of up to limit records each with name, date, amount_usd, chains, classification, technique, target_type, and returned_funds. **Example:** `{"limit": 20, "min_amount_usd": 1250000}` ---