allCryptocurrencyListings
Retrieve a paginated list of all active cryptocurrencies, filtering by market data such as price, market cap, volume, and supply. Ideal for tracking and analyzing cryptocurrency metrics.
Instructions
Returns a paginated list of all active cryptocurrencies with latest market data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aux | No | ||
| circulating_supply_max | No | ||
| circulating_supply_min | No | ||
| convert | No | ||
| convert_id | No | ||
| cryptocurrency_type | No | ||
| limit | No | ||
| market_cap_max | No | ||
| market_cap_min | No | ||
| percent_change_24h_max | No | ||
| percent_change_24h_min | No | ||
| price_max | No | ||
| price_min | No | ||
| sort | No | ||
| sort_dir | No | ||
| start | No | ||
| tag | No | ||
| volume_24h_max | No | ||
| volume_24h_min | No |
Implementation Reference
- index.js:232-237 (handler)The handler function for the 'allCryptocurrencyListings' tool. It invokes handleEndpoint which makes an API request to the CoinMarketCap '/v1/cryptocurrency/listings/latest' endpoint using the provided parameters and formats the response.async (params) => { return handleEndpoint(async () => { const data = await makeApiRequest(apiKey, '/v1/cryptocurrency/listings/latest', params) return formatResponse(data) }) }
- index.js:211-231 (schema)Input schema using Zod for validating parameters such as pagination (start, limit), filters (price_min/max, etc.), sorting (sort, sort_dir), and other options for the cryptocurrency listings query.{ start: z.number().optional(), limit: z.number().min(1).max(5000).optional(), price_min: z.number().optional(), price_max: z.number().optional(), market_cap_min: z.number().optional(), market_cap_max: z.number().optional(), volume_24h_min: z.number().optional(), volume_24h_max: z.number().optional(), circulating_supply_min: z.number().optional(), circulating_supply_max: z.number().optional(), percent_change_24h_min: z.number().optional(), percent_change_24h_max: z.number().optional(), convert: z.string().optional(), convert_id: z.string().optional(), sort: z.enum(['market_cap', 'name', 'symbol', 'date_added', 'price', 'circulating_supply', 'total_supply', 'max_supply', 'num_market_pairs', 'volume_24h', 'percent_change_1h', 'percent_change_24h', 'percent_change_7d']).optional(), sort_dir: z.enum(['asc', 'desc']).optional(), cryptocurrency_type: z.string().optional(), tag: z.string().optional(), aux: z.string().optional() },
- index.js:209-238 (registration)The registration call for the 'allCryptocurrencyListings' tool using server.tool(), specifying the tool name, description, input schema, and handler function.server.tool("allCryptocurrencyListings", "Returns a paginated list of all active cryptocurrencies with latest market data.", { start: z.number().optional(), limit: z.number().min(1).max(5000).optional(), price_min: z.number().optional(), price_max: z.number().optional(), market_cap_min: z.number().optional(), market_cap_max: z.number().optional(), volume_24h_min: z.number().optional(), volume_24h_max: z.number().optional(), circulating_supply_min: z.number().optional(), circulating_supply_max: z.number().optional(), percent_change_24h_min: z.number().optional(), percent_change_24h_max: z.number().optional(), convert: z.string().optional(), convert_id: z.string().optional(), sort: z.enum(['market_cap', 'name', 'symbol', 'date_added', 'price', 'circulating_supply', 'total_supply', 'max_supply', 'num_market_pairs', 'volume_24h', 'percent_change_1h', 'percent_change_24h', 'percent_change_7d']).optional(), sort_dir: z.enum(['asc', 'desc']).optional(), cryptocurrency_type: z.string().optional(), tag: z.string().optional(), aux: z.string().optional() }, async (params) => { return handleEndpoint(async () => { const data = await makeApiRequest(apiKey, '/v1/cryptocurrency/listings/latest', params) return formatResponse(data) }) } )