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)
    })
  }
)

CoinMarketCap MCP