--- name: x402.coinstats.app description: x402.coinstats.app exposes CoinStats data via seven discrete HTTP skills covering cryptocurrency market data, fiat exchange rates, global market statistics, market sentiment, supported blockchains, supported exchanges, and news source metadata. All endpoints return point-in-time snapshots; none provide streaming, historical time-series, or trade execution. The host is read-only and reference-data oriented. host: x402.coinstats.app --- # x402.coinstats.app CoinStats is a crypto portfolio and market data aggregator. This host surfaces its reference and market-snapshot layer: coin prices and metadata, fiat rates, global market stats, the Fear and Greed Index, and enumeration endpoints for supported blockchains, exchanges, and news sources. It serves agents that need to populate selectors, contextualize portfolio data, or summarize market conditions — not agents that need tick-level data, order books, or historical OHLCV series. ## When to use this host Use this host when an agent needs read-only, point-in-time crypto market data, fiat conversion rates, global market stats, sentiment via the Fear and Greed Index, or enumeration of CoinStats-supported blockchains and exchanges. It is well-suited for market summaries, portfolio context, currency conversion, and integration setup flows. Do not use it for: historical OHLCV or time-series data (use a dedicated OHLCV API such as CoinGecko or CryptoCompare); real-time streaming prices (use a WebSocket-based feed); actual news article content (this host only returns source metadata, not articles); trade execution or order placement (use an exchange API directly); or checking live wallet balances (use a CoinStats portfolio endpoint not exposed here). ## Capabilities ### Market Snapshot Provides current price, market cap, volume, supply, and dominance data at both the individual-coin and global-market level, giving agents a full picture of market conditions at a point in time. - **`fetch-coins-market-data`** — Returns paginated cryptocurrency market data including price, market cap, volume, supply, and recent price changes for top coins, with optional filtering by name, symbol, category, blockchain, or contract address. - **`fetch-global-crypto-market-stats`** — Returns current global cryptocurrency market statistics including total market cap, 24h trading volume, Bitcoin dominance, and their 24h percentage changes. ### Market Sentiment Returns the Crypto Fear and Greed Index for today, yesterday, and last week, enabling agents to assess and compare broad investor sentiment across short time horizons. - **`fetch-fear-and-greed-index`** — Returns the current Crypto Fear and Greed Index value and classification, plus reference values for yesterday and last week. ### Currency & FX Reference Returns fiat-to-USD exchange rates with symbols and flag icons, allowing agents to convert crypto prices into local currencies or populate currency selectors. - **`fetch-fiat-rates`** — Returns a list of fiat currencies with their USD exchange rates, currency symbols, and flag image URLs from CoinStats. ### Integration Enumeration Enumerates all blockchains and exchanges supported by CoinStats for wallet and portfolio connections, including the exact credential fields required per exchange and chain identifiers needed by other CoinStats endpoints. - **`fetch-wallet-blockchains`** — Returns the full list of blockchains supported by CoinStats for wallet connections, including display name, connectionId, icon URL, and internal chain identifier for each network. - **`fetch-exchange-support-list`** — Returns the full list of cryptocurrency exchanges supported by CoinStats for portfolio connection, including each exchange's connectionId, name, icon URL, and required credential fields. ### News Source Registry Returns metadata for all cryptocurrency news sources tracked by CoinStats, including RSS feed URLs, website URLs, and logos, enabling agents to build source filters or resolve feed addresses before fetching articles elsewhere. - **`fetch-news-sources`** — Returns the full list of cryptocurrency news sources tracked by CoinStats, including source names, website URLs, RSS feed URLs, logo filenames, source images, and creation/update timestamps. ## Workflows ### Market Context Summary *Use when an agent needs to produce a holistic snapshot of current crypto market conditions, combining macro-level stats, sentiment, and top-coin data for a report or decision brief.* 1. **`fetch-global-crypto-market-stats`** — Retrieve total market cap, 24h volume, BTC dominance, and their percentage changes as the macro baseline. 2. **`fetch-fear-and-greed-index`** — Fetch current Fear and Greed Index and compare to yesterday and last week to characterize investor sentiment alongside the macro data. 3. **`fetch-coins-market-data`** — Pull top coins by rank or a filtered subset to add per-asset price and volume detail to the summary. ### Localized Coin Pricing *Use when an agent needs to display cryptocurrency prices in a user's local fiat currency rather than USD.* 1. **`fetch-fiat-rates`** — Retrieve the USD exchange rate for the target fiat currency. 2. **`fetch-coins-market-data`** — Fetch current USD prices for the relevant coins, then apply the fiat rate to convert displayed prices into the local currency. ### Exchange Portfolio Onboarding Prep *Use when an agent needs to guide a user through connecting an exchange account to CoinStats and must present valid exchange options with their required credential fields.* 1. **`fetch-exchange-support-list`** — Enumerate all supported exchanges and their required credential fields so the agent can present valid options and prompt for the correct keys. 2. **`fetch-wallet-blockchains`** — If the user also wants to connect a wallet, enumerate supported blockchains to resolve the correct connectionId and chain identifier for the target network. ## Skill reference ### `fetch-coins-market-data` **CoinStats Coins Market Data** — Returns paginated cryptocurrency market data including price, market cap, volume, supply, and recent price changes for top coins, with optional filtering by name, symbol, category, blockchain, or contract address. *Use when:* Use when an agent needs current market data (price, market cap, volume, supply, price changes) for one or more cryptocurrencies, or wants to search/filter coins by name, symbol, category, blockchain, or contract address. *Not for:* Do not use for real-time streaming price feeds or historical OHLCV data; this is a single paginated snapshot of current market state. **Inputs:** - `page` (number) — Page number to retrieve (1-based indexing). - `limit` (number) — Number of items to return per page. - `coinIds` (string) — Filter coins by specific coin IDs. Use comma-separated values to specify multiple coins. - `currency` (string) — The currency to display coin prices and market data in. - `name` (string) — Search for coins by their name. Supports partial matching (e.g., 'bit' matches 'Bitcoin'). - `symbol` (string) — Filter coins by their ticker symbol (e.g., BTC for Bitcoin, ETH for Ethereum). - `contractAddresses` (string) — Filter coins by smart contract addresses. Use comma-separated values. Matching is case-insensitive. - `blockchains` (string) — Filter coins by blockchain networks. Use comma-separated values. Common values: ethereum, solana, binance-smart-chain, polygon, avalanche. - `includeRiskScore` (string) — Include risk score data in the response. Set to 'true' to include risk assessment metrics. - `categories` (string) — Filter coins by categories. Use comma-separated values. Common categories: defi, memecoins, gaming, nft, metaverse, layer-1, layer-2. - `sortBy` (string) — Field to sort results by (e.g., marketCap, rank). **Returns:** Returns a 'result' array of coin objects each containing id, name, symbol, rank, price, priceBtc, volume, marketCap, availableSupply, totalSupply, priceChange1h/1d/1w/1m, contractAddresses, and optional riskScore fields. **Example:** `GET https://x402.coinstats.app/coins?page=1&limit=20¤cy=USD&sortBy=marketCap` --- ### `fetch-fiat-rates` **CoinStats Fiat Rates** — Returns a list of fiat currencies with their USD exchange rates, currency symbols, and flag image URLs from CoinStats. *Use when:* Use when an agent needs current fiat-to-USD exchange rates, currency symbols, or flag icons for a set of supported fiat currencies to perform currency conversion, display pricing in local currencies, or populate a currency selector. *Not for:* Do not use for cryptocurrency price data; use a crypto market endpoint instead. Not suitable for real-time streaming rates — this is a single-shot snapshot. **Returns:** Returns a JSON array of ~34 fiat currency objects, each with a currency code (name), USD exchange rate (rate), display symbol, and a flag image URL. **Example:** `GET https://x402.coinstats.app/fiats` --- ### `fetch-wallet-blockchains` **CoinStats Wallet Blockchains** — Returns the full list of blockchains supported by CoinStats for wallet connections, including display name, connectionId, icon URL, and internal chain identifier for each network. *Use when:* Use when an agent needs to enumerate all CoinStats-supported blockchain networks to populate a wallet/network selector, validate a chain name, resolve a connectionId, or map chain identifiers before calling other CoinStats wallet endpoints. *Not for:* Do not use to fetch live blockchain data, token prices, or wallet balances; use dedicated CoinStats portfolio or market endpoints instead. **Returns:** Returns a JSON array of blockchain objects, each with connectionId, name, icon URL, and chain identifier; the real response includes 25+ networks such as BNB Smart Chain, Solana, Polygon, Arbitrum, and Optimism. **Example:** `GET https://x402.coinstats.app/wallet/blockchains` --- ### `fetch-exchange-support-list` **Exchange Support List** — Returns the full list of cryptocurrency exchanges supported by CoinStats for portfolio connection, including each exchange's connectionId, name, icon URL, and required credential fields. *Use when:* Use when an agent or UI needs to enumerate which exchanges CoinStats supports for portfolio integration and must know the exact credential fields (e.g., apiKey, apiSecret, passphrase, customerId) required to connect each one. *Not for:* Do not use to retrieve live exchange rates, market prices, or trading data; use a market data endpoint instead. Not suitable for checking connection status of an already-linked account. **Returns:** Returns a JSON array where each element describes a supported exchange with its connectionId, name, icon URL, and an ordered connectionFields array listing the credential keys needed to connect it. **Example:** `GET https://x402.coinstats.app/exchange/support` --- ### `fetch-news-sources` **CoinStats News Sources** — Returns the full list of cryptocurrency news sources tracked by CoinStats, including source names, website URLs, RSS feed URLs, logo filenames, source images, and creation/update timestamps. *Use when:* Use when an agent needs to enumerate available cryptocurrency news sources, resolve a source's RSS feed URL or website URL, or display source metadata such as logos and names for filtering or display purposes. *Not for:* Do not use to fetch actual news articles or headlines; use a news articles endpoint instead. Not suitable for real-time price or market data. **Returns:** Returns a JSON array of news source objects, each containing sourcename, logo, sourceImg, weburl, feedurl, optional coinid, and _created_at/_updated_at timestamps. **Example:** `GET https://x402.coinstats.app/news/sources` --- ### `fetch-fear-and-greed-index` **CoinStats Fear and Greed Index** — Returns the current Crypto Fear and Greed Index value and classification, plus reference values for yesterday and last week. *Use when:* Use when an agent needs to assess current crypto market sentiment via the Fear and Greed Index, or compare today's sentiment to yesterday or last week to detect shifts in investor mood. *Not for:* Do not use for historical time-series data beyond yesterday and last week; use a dedicated historical sentiment or price API instead. Not suitable for individual asset sentiment — this is a market-wide index. **Returns:** Returns a JSON object with the index name, current value and classification with update timestamp, and equivalent value/classification/timestamp pairs for yesterday and last week. **Example:** `GET https://x402.coinstats.app/insights/fear-and-greed` --- ### `fetch-global-crypto-market-stats` **CoinStats Global Markets** — Returns current global cryptocurrency market statistics including total market cap, 24h trading volume, Bitcoin dominance, and their 24h percentage changes. *Use when:* Use when an agent needs a snapshot of the overall crypto market — total market cap, trading volume, BTC dominance, and recent percentage changes — to inform trading decisions, market summaries, or portfolio context. *Not for:* Do not use for per-coin price data or historical market data; use a coin-specific or historical endpoint instead. **Returns:** Returns a JSON object with marketCap, volume, btcDominance, marketCapChange, volumeChange, and btcDominanceChange as numeric values reflecting current global crypto market conditions. **Example:** `GET https://x402.coinstats.app/markets` ---