--- name: md.fastdb.in description: md.fastdb.in provides live on-chain and DeFi data utilities: current crypto spot prices, DeFi protocol TVL snapshots, EVM gas prices across major chains, and HTML-to-image rendering. All data endpoints return current snapshots only, with no historical or streaming capabilities. host: md.fastdb.in --- # md.fastdb.in md.fastdb.in is a small-footprint utility host serving agents that need real-time financial data (prices, TVL, gas) and image generation from HTML. It covers common pre-trade and portfolio-display data needs across up to 25 crypto assets, 10 DeFi protocols, and 5 EVM chains in single-shot requests. The HTML renderer is an unrelated utility for generating static images from markup, bundled on the same host. ## When to use this host Use md.fastdb.in when an agent needs current-snapshot crypto prices (up to 25 assets), DeFi TVL (up to 10 protocols), or EVM gas estimates (up to 5 chains) in a single-shot request with low integration overhead. The HTML renderer is appropriate for generating static images from markup without standing up a browser service. Do not use this host for historical price data, OHLCV candlesticks, or time-series TVL — use DefiLlama's historical API or a dedicated OHLCV provider instead. Do not use it for non-EVM chains (e.g. Solana, Cosmos gas) or for capturing live remote URLs. It is not suitable for streaming or high-frequency polling scenarios. ## Capabilities ### Live Crypto Pricing Fetches current USD spot prices for crypto assets identified by ticker, CoinGecko ID, or on-chain contract address, with confidence scores and source timestamps for up to 25 assets per call. - **`fetch-crypto-spot-prices`** — Returns live USD spot prices for up to 25 crypto assets identified by ticker symbol, CoinGecko ID, or chain-prefixed token address, with confidence scores and source metadata. ### DeFi Protocol TVL Returns the current USD total value locked for up to 10 DeFi protocols by their DefiLlama slug, providing a snapshot of protocol liquidity size. - **`fetch-defi-tvl`** — Returns current USD total value locked (TVL) for one or more DeFi protocols by their DefiLlama slug, sourced from DefiLlama. ### EVM Gas Estimation Retrieves live base fee, priority fee tiers, block number, native asset price, and estimated USD transfer cost for up to 5 major EVM chains simultaneously. - **`fetch-multichain-gas-prices`** — Returns live gas pricing for up to 5 EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon), including base fee, priority fee tiers, block number, native asset price, and estimated USD transfer cost per chain. ### HTML Image Rendering Converts caller-supplied HTML/CSS/JS strings into base64-encoded PNG or JPEG images at configurable dimensions, suitable for OG cards, invoices, badges, and UI previews. - **`render-html-to-image`** — Renders caller-supplied HTML/CSS/JS to a PNG or JPEG image and returns the result as base64-encoded content with metadata, at a default canvas size of 1200x630. ## Workflows ### Pre-Trade Cost Estimation *Use when an agent needs to determine the cheapest EVM chain to execute a token swap or transfer, expressed in USD, before submitting a transaction.* 1. **`fetch-multichain-gas-prices`** — Retrieve current gas prices and estimated USD transfer costs across the candidate EVM chains. 2. **`fetch-crypto-spot-prices`** — Fetch the current USD price of the token being transferred to compute the total USD cost of the transaction relative to the asset value. ### DeFi Dashboard Card Generation *Use when an agent needs to produce a shareable image summarizing a DeFi protocol's TVL and the current price of its native token.* 1. **`fetch-defi-tvl`** — Retrieve the current USD TVL for the target DeFi protocol. 2. **`fetch-crypto-spot-prices`** — Fetch the current USD spot price for the protocol's native token. 3. **`render-html-to-image`** — Render an HTML template populated with the TVL and price data into a PNG or JPEG image for display or sharing. ## Skill reference ### `fetch-defi-tvl` **DeFi TVL Lookup** — Returns current USD total value locked (TVL) for one or more DeFi protocols by their DefiLlama slug, sourced from DefiLlama. *Use when:* Use when an agent needs the current USD TVL for one or more DeFi protocols (e.g. Uniswap, Aave) identified by their DefiLlama slug, up to 10 protocols per request. *Not for:* Do not use for historical TVL time series or token price lookups; this returns only the current snapshot TVL per protocol. **Inputs:** - `protocols` (array, required) — Array of DefiLlama protocol slugs to query TVL for. Maximum 10 items per request. **Returns:** Returns a tvl object keyed by protocol slug each with a usd amount, an ISO 8601 timestamp in at, source set to defillama, and a ms latency integer. **Example:** `{"protocols": ["uniswap", "aave"]}` --- ### `fetch-crypto-spot-prices` **FastDB Pulse Price** — Returns live USD spot prices for up to 25 crypto assets identified by ticker symbol, CoinGecko ID, or chain-prefixed token address, with confidence scores and source metadata. *Use when:* Use when an agent needs current USD prices for one or more crypto assets (e.g. ETH, BTC, or an EVM token by contract address) with ~15-second freshness and a confidence score, before executing trades, displaying portfolio values, or computing USD-denominated amounts. *Not for:* Do not use for historical price data or OHLCV candlestick data; use a dedicated historical price API instead. Not suitable for streaming price feeds — this is a single-shot request. **Inputs:** - `coins` (array, required) — List of up to 25 asset identifiers: ticker symbols (BTC, ETH, SOL), CoinGecko IDs prefixed with 'coingecko:' (coingecko:bitcoin), or chain-prefixed token addresses (:
). **Returns:** Returns a prices map keyed by each requested identifier with usd price, symbol, decimals, confidence (0.99), sourceTimestamp, and key, plus a top-level at timestamp, source (defillama), and ms latency. **Example:** `{"coins": ["ETH", "BTC", "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}` --- ### `render-html-to-image` **HTML to PNG/JPEG Renderer** — Renders caller-supplied HTML/CSS/JS to a PNG or JPEG image and returns the result as base64-encoded content with metadata, at a default canvas size of 1200x630. *Use when:* Use when an agent needs to generate a static image from HTML markup — such as OG/social cards, invoices, receipts, badges, or UI previews — and requires the output as a base64-encoded PNG or JPEG with dimensions and byte size. *Not for:* Do not use for capturing live URLs or remote web pages; this endpoint only renders caller-supplied HTML strings. Not suitable for streaming or animated output. **Inputs:** - `html` (string, required) — HTML document or fragment to render (max 2 MB). JavaScript is allowed. - `width` (integer) — Canvas width in pixels, minimum 16, maximum 1920. Default is 1200. - `height` (integer) — Canvas height in pixels, minimum 16, maximum 1920. Default is 630. - `fullPage` (boolean) — When true, captures the full content height instead of the fixed canvas size. - `selector` (string) — CSS selector to capture only a specific element instead of the full canvas. - `transparent` (boolean) — When true, omits the default white background. PNG format only. - `format` (string) — Output image format: 'png' or 'jpeg'. Default is 'png'. - `quality` (integer) — JPEG compression quality, 1–100. Default is 80. Applies to JPEG format only. - `scale` (number) — Device scale factor: 1 (default) or 2 (retina/HiDPI). - `waitMs` (integer) — Additional settle time in milliseconds after page load, 0–10000. - `response` (string) — Response mode: 'json' (default) wraps image as base64; 'binary' returns raw image bytes. **Returns:** Returns ok=true with contentType='image/png', rendered width/height in pixels, byte size, SHA-256 digest, and a base64-encoded PNG in the b64 field. **Example:** `{"html":"
Hello, agents
","format":"png","scale":1}` --- ### `fetch-multichain-gas-prices` **Multi-Chain Gas Prices** — Returns live gas pricing for up to 5 EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon), including base fee, priority fee tiers, block number, native asset price, and estimated USD transfer cost per chain. *Use when:* Use when an agent needs current gas prices across one or more EVM chains to compare transaction costs, estimate fees before submitting a transaction, or decide which chain is cheapest for a transfer. *Not for:* Do not use for non-EVM chains or for historical gas data; this endpoint returns only current live gas prices. **Inputs:** - `chains` (array) — List of EVM chain names to query. Supported values: 'ethereum', 'base', 'arbitrum', 'optimism', 'polygon'. Omit to get all supported chains. **Returns:** Returns a gas object keyed by chain name, each containing blockNumber, gasPriceGwei, baseFeeGwei, slow/standard/fast priority fees in Gwei, nativeUsd price, and transferCostUsd, plus a top-level at timestamp and ms latency field. **Example:** `{"chains": ["base", "ethereum"]}` ---