`get_market_data`

Pack: coingecko · Endpoint: https://gateway.pipeworx.io/coingecko/mcp

Get top cryptocurrencies ranked by market cap with current prices, 24h changes, and volume. Example: get_market_data({ vs_currency: “usd”, limit: 10 })

Parameters

Name	Type	Required	Description
`vs_currency`	string	no	Currency to show prices in, e.g. “usd”, “eur”, “btc” (default: “usd”)
`order`	string	no	Sort order: “market_cap_desc”, “volume_desc”, “price_desc” (default: “market_cap_desc”)
`limit`	number	no	Number of coins to return, 1-250 (default: 20)

Example call

Arguments

{
  "vs_currency": "usd",
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/coingecko/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_data","arguments":{"vs_currency":"usd","limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_market_data', {
  "vs_currency": "usd",
  "limit": 10
});

More examples

{
  "vs_currency": "eur",
  "order": "volume_desc",
  "limit": 25
}

Response shape

Always returns: vs_currency, count, coins

Field	Type	Description
`vs_currency`	string	Currency prices are displayed in
`count`	number	Number of coins returned
`coins`	array	Top coins ranked by market cap

Full JSON Schema

{
  "type": "object",
  "properties": {
    "vs_currency": {
      "type": "string",
      "description": "Currency prices are displayed in"
    },
    "count": {
      "type": "number",
      "description": "Number of coins returned"
    },
    "coins": {
      "type": "array",
      "description": "Top coins ranked by market cap",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "CoinGecko coin ID"
          },
          "symbol": {
            "type": "string",
            "description": "Coin symbol"
          },
          "name": {
            "type": "string",
            "description": "Coin name"
          },
          "rank": {
            "type": "number",
            "description": "Market cap rank"
          },
          "price": {
            "type": "number",
            "description": "Current price in vs_currency"
          },
          "market_cap": {
            "type": "number",
            "description": "Market capitalization in vs_currency"
          },
          "volume_24h": {
            "type": "number",
            "description": "24-hour trading volume in vs_currency"
          },
          "change_24h_pct": {
            "type": "number",
            "description": "24-hour price change percentage"
          },
          "high_24h": {
            "type": "number",
            "description": "24-hour high price in vs_currency"
          },
          "low_24h": {
            "type": "number",
            "description": "24-hour low price in vs_currency"
          }
        },
        "required": [
          "id",
          "symbol",
          "name",
          "rank",
          "price",
          "market_cap",
          "volume_24h",
          "change_24h_pct",
          "high_24h",
          "low_24h"
        ]
      }
    }
  },
  "required": [
    "vs_currency",
    "count",
    "coins"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "coingecko": {
      "url": "https://gateway.pipeworx.io/coingecko/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_market_data