--- name: stablecrypto.dev description: stablecrypto.dev aggregates on-chain and market data from multiple sources including Etherscan, Alchemy, DeFiLlama, and CoinGecko into a unified set of lookup and analytics skills. It covers EVM contract metadata, token prices, stablecoin supply history, chain TVL, and exchange volume. All skills return read-only data; no transaction submission or order execution is supported. host: stablecrypto.dev --- # stablecrypto.dev stablecrypto.dev is a multi-source data aggregation host targeting agents that need to combine on-chain EVM metadata with off-chain market and DeFi analytics. It serves use cases such as contract auditing workflows, token research, stablecoin monitoring, and macro crypto market analysis. Its distinguishing characteristic is breadth across four distinct data providers (Etherscan, Alchemy, DeFiLlama, CoinGecko) rather than depth in any single one. ## When to use this host Use stablecrypto.dev when an agent needs read-only data spanning EVM contract metadata, token prices, stablecoin supply trends, chain TVL, or global market snapshots without needing to integrate multiple provider APIs directly. It is well-suited for research, analytics, and audit workflows. Do not use it for: submitting or simulating transactions (no execution capability), fetching unverified contract ABIs or source code, real-time streaming or tick-level price data, protocol-level DeFi TVL (only chain-level TVL is available), NFT metadata, or tokens not indexed by Alchemy, DeFiLlama, or CoinGecko. For live order book or ticker data prefer a dedicated exchange API. For protocol-specific TVL use DeFiLlama's protocol endpoint directly. ## Capabilities ### EVM Contract Metadata Resolves smart contract addresses into deployment provenance and interface definitions, enabling agents to identify deployers, creation transactions, and callable ABIs for verified contracts on any EVM-compatible chain. - **`fetch-contract-creation`** — Returns the creator address, transaction hash, block number, timestamp, and creation bytecode for up to 5 EVM contract addresses on a specified chain. - **`fetch-contract-abi`** — Retrieves the verified ABI JSON string for a smart contract on any supported EVM chain, given a chain ID and contract address. ### Block and Validator Data Retrieves finalized block reward details including miner address, block reward, and uncle data for EVM chains, useful for validator accounting and block-level analytics. - **`fetch-block-reward`** — Returns the block reward, uncle inclusion reward, and uncle list for a specified block number on any EVM-compatible chain via Etherscan. ### Token Identity and Pricing Resolves token contract addresses to human-readable metadata and retrieves current or historical USD prices across multiple networks and data providers. - **`fetch-token-metadata`** — Returns name, symbol, decimals, and logo URL for a token contract address on a specified Alchemy-supported network. - **`fetch-defillama-coin-prices`** — Returns current prices, symbols, timestamps, and confidence scores for one or more tokens identified by chain-prefixed contract address or CoinGecko ID via DeFiLlama. - **`fetch-historical-token-prices`** — Returns time-series token price data in USD for an Alchemy-supported asset over a specified date range and interval. ### Stablecoin Analytics Provides daily time-series data on stablecoin circulating supply and market cap, enabling trend analysis and monitoring of individual stablecoin health over time. - **`fetch-stablecoin-charts`** — Returns a daily time-series of circulating supply and USD market cap for a specific stablecoin, sourced from DefiLlama. ### DeFi and Chain Macro Analytics Tracks total-value-locked history at the chain level and exchange trading volume over time, supporting DeFi growth analysis and cross-chain or cross-exchange comparisons. - **`fetch-chain-tvl-history`** — Returns a daily historical TVL time series for a named blockchain network, sourced from DeFiLlama. - **`fetch-exchange-volume-chart`** — Returns a time-series array of [timestamp, volume] pairs representing an exchange's trading volume history from CoinGecko for a specified number of days. ### Global Market Snapshot Returns a single-call summary of the entire crypto market including total market cap, dominance figures, and active asset counts from CoinGecko. - **`fetch-crypto-global-snapshot`** — Returns the latest global crypto market statistics from CoinGecko, including total market cap, total volume, dominance percentages, and active cryptocurrency counts. ## Workflows ### Token Research Dossier *Use when an agent needs to build a complete profile of an EVM token including its identity, current price, and historical price trend.* 1. **`fetch-token-metadata`** — Resolve the contract address to human-readable name, symbol, decimals, and logo. 2. **`fetch-defillama-coin-prices`** — Fetch the current USD price and confidence score for the token using its chain-prefixed address. 3. **`fetch-historical-token-prices`** — Retrieve a time-series of historical prices over a chosen window and interval for charting or backtesting context. ### Contract Provenance and Interface Audit *Use when an agent needs to verify who deployed a contract and obtain its ABI for decoding or interaction planning.* 1. **`fetch-contract-creation`** — Identify the deployer address, creation transaction hash, block number, and timestamp for the contract. 2. **`fetch-contract-abi`** — Retrieve the verified ABI to inspect available functions and events or prepare calldata encoding. ### Chain DeFi Health Check *Use when an agent needs to contextualize a chain's DeFi ecosystem size against the broader crypto market.* 1. **`fetch-chain-tvl-history`** — Pull the historical daily TVL series for the target chain to assess DeFi growth or decline trends. 2. **`fetch-crypto-global-snapshot`** — Retrieve global market cap, dominance, and volume figures to place the chain's TVL in macro context. ## Skill reference ### `fetch-block-reward` **Block Reward Lookup** — Returns the block reward, uncle inclusion reward, and uncle list for a specified block number on any EVM-compatible chain via Etherscan. *Use when:* Use when an agent needs to retrieve the miner reward, uncle rewards, and block metadata for a specific Ethereum or EVM-compatible block number, such as for accounting, analytics, or validator reward tracking. *Not for:* Do not use for real-time gas price feeds or pending block data; this endpoint only returns finalized block reward data for a given block number. **Inputs:** - `chainid` (number, required) — EVM chain ID identifying the target network (e.g. 1=Ethereum, 137=Polygon, 8453=Base). - `blockno` (number, required) — Block number for which to retrieve the block and uncle rewards. **Returns:** Returns blockNumber, timeStamp, blockMiner address, blockReward in wei, an uncles array, and uncleInclusionReward in wei for the specified block. **Example:** `{"chainid": 1, "blockno": 19537393}` --- ### `fetch-contract-creation` **Contract Creator Lookup** — Returns the creator address, transaction hash, block number, timestamp, and creation bytecode for up to 5 EVM contract addresses on a specified chain. *Use when:* Use when an agent needs to identify who deployed a smart contract, when it was deployed, or retrieve the creation transaction hash and bytecode for one or more contract addresses on an EVM-compatible chain. *Not for:* Do not use for fetching current contract state, ABI, or source code; use a contract ABI or source-code endpoint instead. Not suitable for non-EVM chains. **Inputs:** - `chainid` (number, required) — EVM chain ID identifying the target network (e.g. 1=Ethereum, 137=Polygon, 8453=Base). - `contractaddresses` (string, required) — Comma-separated list of contract addresses to look up (maximum 5 addresses). **Returns:** Returns an array of objects, one per found contract, each containing contractAddress, contractCreator, txHash, blockNumber, timestamp, contractFactory, and creationBytecode. **Example:** `{"chainid": 1, "contractaddresses": "0x6B175474E89094C44Da98b954EedeAC495271d0F,0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}` --- ### `fetch-contract-abi` **ABI Fetcher** — Retrieves the verified ABI JSON string for a smart contract on any supported EVM chain, given a chain ID and contract address. *Use when:* Use when an agent needs the ABI of a verified EVM smart contract to decode calldata, encode transactions, or inspect available functions and events on chains like Ethereum, Polygon, or Base. *Not for:* Do not use for unverified contracts (no ABI will be available) or for fetching contract source code, bytecode, or storage layout — those require different endpoints. **Inputs:** - `chainid` (number, required) — EVM chain ID identifying the target network (e.g. 1=Ethereum, 137=Polygon, 8453=Base). - `address` (string, required) — Verified contract address on the specified chain. **Returns:** Returns a JSON-encoded ABI string containing all constructor, function, and event entries for the verified contract (e.g. DAI on Ethereum includes transfer, approve, permit, DOMAIN_SEPARATOR, and Maker-style wards entries). **Example:** `{"chainid": 1, "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F"}` --- ### `fetch-historical-token-prices` **Alchemy Historical Prices** — Returns time-series token price data in USD for an Alchemy-supported asset over a specified date range and interval. *Use when:* Use when an agent needs historical price data for a token (e.g. ETH, USDC) over a defined time window with a chosen granularity such as 5m, 1h, or 1d, for charting, backtesting, or analytics. *Not for:* Do not use for real-time or streaming spot prices; use a live price feed endpoint instead. Not suitable for tokens not supported by Alchemy's price API. **Inputs:** - `network` (string, required) — Alchemy network slug identifying the chain, e.g. eth-mainnet or base-mainnet. - `symbol` (string, required) — Token symbol to retrieve historical prices for. - `startTime` (string, required) — ISO 8601 timestamp marking the start of the historical window (inclusive). - `endTime` (string, required) — ISO 8601 timestamp marking the end of the historical window (inclusive). - `interval` (string) — Time interval between data points, e.g. 5m, 1h, 1d. Defaults to provider default if omitted. **Returns:** Returns an object with symbol, currency (usd), and a data array of timestamp/value pairs representing hourly ETH prices over the requested window. **Example:** `{"network":"eth-mainnet","symbol":"ETH","startTime":"2026-05-20T00:00:00Z","endTime":"2026-05-27T23:59:59Z","interval":"1h"}` --- ### `fetch-token-metadata` **Token Metadata Lookup** — Returns name, symbol, decimals, and logo URL for a token contract address on a specified Alchemy-supported network. *Use when:* Use when an agent needs to resolve a token contract address into human-readable metadata (name, symbol, decimals, logo) on EVM-compatible networks such as Ethereum mainnet or Base mainnet. *Not for:* Do not use for token price or balance lookups; use a price feed or balance API instead. Not suitable for NFT contract metadata — this targets fungible token contracts. **Inputs:** - `network` (string, required) — Alchemy network slug identifying the chain to query. - `contractAddress` (string, required) — EVM token contract address to look up metadata for. **Returns:** Returns a JSON object with the token's name, symbol, decimals, and logo URL (e.g. name="Dai", symbol="DAI", decimals=18). **Example:** `{"network": "eth-mainnet", "contractAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F"}` --- ### `fetch-stablecoin-charts` **Stablecoin Charts** — Returns a daily time-series of circulating supply and USD market cap for a specific stablecoin, sourced from DefiLlama. *Use when:* Use when an agent needs historical daily market cap or circulating supply data for a specific stablecoin identified by its DefiLlama numeric ID, such as for trend analysis or charting. *Not for:* Do not use for real-time price feeds or cross-asset comparisons across multiple stablecoins in a single call; query each stablecoin ID separately. **Inputs:** - `stablecoin` (number) — DefiLlama numeric stablecoin ID to filter chart data. Omit to retrieve aggregate data across all stablecoins. **Returns:** Returns an array of daily objects each containing a Unix date string, totalCirculating.peggedUSD (native units), and totalCirculatingUSD.peggedUSD (USD value), spanning the full historical range for the requested stablecoin. **Example:** `{"stablecoin": 1}` --- ### `fetch-defillama-coin-prices` **DeFiLlama Coin Prices** — Returns current prices, symbols, timestamps, and confidence scores for one or more tokens identified by chain-prefixed contract address or CoinGecko ID via DeFiLlama. *Use when:* Use when an agent needs current USD prices for one or more on-chain tokens or CoinGecko-listed assets, identified by addresses like 'ethereum:0x...' or slugs like 'coingecko:bitcoin'. *Not for:* Do not use for historical OHLCV data or time-series price charts; use a dedicated historical price endpoint instead. Not suitable for tokens not indexed by DeFiLlama. **Inputs:** - `coins` (string, required) — Comma-separated coin IDs in the format 'chain:0xAddress' or 'coingecko:slug' (e.g. 'ethereum:0x6b175474e89094c44da98b954eedeac495271d0f,coingecko:bitcoin'). - `searchWidth` (string) — Time range within which to search for the most recent price data (e.g. '4h', '1d'). Defaults to a platform-defined window if omitted. **Returns:** Returns a 'coins' map where each key is the requested coin ID and each value contains price (USD float), symbol, Unix timestamp, confidence score, and decimals (for contract-address tokens). **Example:** `{"coins": "ethereum:0x6b175474e89094c44da98b954eedeac495271d0f,ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,coingecko:bitcoin", "searchWidth": "4h"}` --- ### `fetch-chain-tvl-history` **Chain TVL Stats** — Returns a daily historical TVL time series for a named blockchain network, sourced from DeFiLlama. *Use when:* Use when an agent needs historical total-value-locked data for a specific blockchain (e.g. Ethereum, Solana) to analyze DeFi growth trends, compare chains, or chart TVL over time. *Not for:* Do not use for protocol-level TVL (individual DeFi protocols); use a protocol TVL endpoint instead. Not suitable for real-time price feeds or token-level data. **Inputs:** - `chain` (string, required) — Chain name as recognized by DeFiLlama (e.g. "Ethereum", "Solana", "BSC"). **Returns:** Returns a JSON array of objects, each with a Unix timestamp date and a numeric tvl in USD, covering daily TVL from the chain's earliest tracked date to the present. **Example:** `{"chain": "Ethereum"}` --- ### `fetch-exchange-volume-chart` **Exchange Volume Chart** — Returns a time-series array of [timestamp, volume] pairs representing an exchange's trading volume history from CoinGecko for a specified number of days. *Use when:* Use when an agent needs historical trading volume data for a specific exchange over a defined time window, such as charting volume trends or computing volume statistics for Binance or other CoinGecko-listed exchanges. *Not for:* Do not use for real-time ticker prices or order book data; use a market data or ticker endpoint instead. Not suitable for token-level volume — this is exchange-level aggregate volume only. **Inputs:** - `id` (string, required) — CoinGecko exchange ID (e.g. 'binance', 'coinbase', 'kraken'). - `days` (string, required) — Number of days of historical volume data to retrieve (as a string integer). **Returns:** Returns a JSON array of [timestamp, volume] pairs with hourly granularity; each entry is a 2-element array of a millisecond Unix timestamp and a high-precision USD volume string. **Example:** `{"id": "binance", "days": "14"}` --- ### `fetch-crypto-global-snapshot` **Crypto Global Snapshot** — Returns the latest global crypto market statistics from CoinGecko, including total market cap, total volume, dominance percentages, and active cryptocurrency counts. *Use when:* Use when an agent needs a current snapshot of the entire crypto market, such as total market capitalization across currencies, 24h volume, BTC/ETH dominance percentages, or the number of active cryptocurrencies and markets. *Not for:* Do not use for individual coin prices or historical data; use a coin-specific or OHLCV endpoint instead. Not suitable for streaming or real-time tick data. **Returns:** Returns a data object with active_cryptocurrencies, markets, total_market_cap and total_volume keyed by currency code, market_cap_percentage dominance map, 24h change percentages, and an updated_at timestamp. **Example:** `POST https://stablecrypto.dev/api/coingecko/global Content-Type: application/json {}` ---