`get_coin`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_coin for the schema, then POST the same URL with its arguments for the data.

Get live cryptocurrency data by CoinGecko ID (e.g., ‘bitcoin’, ‘ethereum’). Returns USD price, market cap, 24h/7d/30d price changes, ATH, circulating supply, and a short description.

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