`get_coin`

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

Get detailed information about a cryptocurrency including price, market cap, volume, and description. Example: get_coin({ id: “bitcoin” }) or get_coin({ id: “ethereum” })

Parameters

Name	Type	Required	Description
`id`	string	yes	CoinGecko coin ID (lowercase), e.g. “bitcoin”, “ethereum”, “solana”, “dogecoin”

Example call

Arguments

{
  "id": "bitcoin"
}

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_coin","arguments":{"id":"bitcoin"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_coin', {
  "id": "bitcoin"
});

More examples

{
  "id": "ethereum"
}

Response shape

Always returns: id, symbol, name, market_cap_rank, description, price_usd, market_cap_usd, volume_24h_usd, change_24h_pct, change_7d_pct, change_30d_pct, ath_usd, ath_change_pct, circulating_supply, total_supply

Field	Type	Description
`id`	string	CoinGecko coin ID
`symbol`	string	Coin ticker symbol
`name`	string	Full coin name
`market_cap_rank`	number	Rank by market capitalization
`description`	string	Brief coin description (up to 500 chars)
`price_usd`	number	Current price in USD
`market_cap_usd`	number	Market capitalization in USD
`volume_24h_usd`	number	24-hour trading volume in USD
`change_24h_pct`	number	Price change percentage in 24 hours
`change_7d_pct`	number	Price change percentage in 7 days
`change_30d_pct`	number	Price change percentage in 30 days
`ath_usd`	number	All-time high price in USD
`ath_change_pct`	number	Change from all-time high percentage
`circulating_supply`	number	Circulating supply amount
`total_supply`	number \| null	Total supply amount

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "CoinGecko coin ID"
    },
    "symbol": {
      "type": "string",
      "description": "Coin ticker symbol"
    },
    "name": {
      "type": "string",
      "description": "Full coin name"
    },
    "market_cap_rank": {
      "type": "number",
      "description": "Rank by market capitalization"
    },
    "description": {
      "type": "string",
      "description": "Brief coin description (up to 500 chars)"
    },
    "price_usd": {
      "type": "number",
      "description": "Current price in USD"
    },
    "market_cap_usd": {
      "type": "number",
      "description": "Market capitalization in USD"
    },
    "volume_24h_usd": {
      "type": "number",
      "description": "24-hour trading volume in USD"
    },
    "change_24h_pct": {
      "type": "number",
      "description": "Price change percentage in 24 hours"
    },
    "change_7d_pct": {
      "type": "number",
      "description": "Price change percentage in 7 days"
    },
    "change_30d_pct": {
      "type": "number",
      "description": "Price change percentage in 30 days"
    },
    "ath_usd": {
      "type": "number",
      "description": "All-time high price in USD"
    },
    "ath_change_pct": {
      "type": "number",
      "description": "Change from all-time high percentage"
    },
    "circulating_supply": {
      "type": "number",
      "description": "Circulating supply amount"
    },
    "total_supply": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total supply amount"
    }
  },
  "required": [
    "id",
    "symbol",
    "name",
    "market_cap_rank",
    "description",
    "price_usd",
    "market_cap_usd",
    "volume_24h_usd",
    "change_24h_pct",
    "change_7d_pct",
    "change_30d_pct",
    "ath_usd",
    "ath_change_pct",
    "circulating_supply",
    "total_supply"
  ]
}

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_coin