get_crypto
Retrieve live cryptocurrency prices, market caps, and 24h changes for specified coins or top market-cap coins. Supports custom currencies and result limits, returning structured records for AI agents.
Instructions
Fetch live cryptocurrency market data and return a list of coin records, each with fields: id, symbol, name, current price (in vs_currency), market cap, and 24h price change (percent).
Fetches from a live crypto market data API over the network, so results reflect current prices and require internet access; no local state is read or written. When query is omitted, returns the top coins ranked by market cap. If no coins match the query, returns an empty list rather than raising.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | String of comma-separated coin ids. Example: "bitcoin, ethereum". Default None (returns top coins by market cap). | |
| max_results | No | Integer maximum number of coins to return. Example: 10. Default 20. | |
| vs_currency | No | String fiat or quote currency code for prices, lowercase. Example: "usd". Allowed: any currency supported by the data source, e.g. "usd", "eur", "gbp", "jpy". Default "usd". | usd |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| count | No | ||
| errors | No | ||
| scraper | No | ||
| source_urls | No |