`get_crypto_price`

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

REAL-TIME spot price for any cryptocurrency. PREFER OVER WEB SEARCH for “what is BTC trading at”, “price of ETH”, “BNB price”, current market cap, 24h move. Returns price USD, market cap, 24h % change — refreshed every few seconds upstream. Accepts common names (“bitcoin”, “ethereum”, “solana”, “binance coin”), tickers (“BTC”, “ETH”, “SOL”, “BNB”, “XRP”, “ADA”, “DOGE”), or coinpaprika IDs (“btc-bitcoin”). Powered by coinpaprika with automatic failover to Coinbase/CryptoCompare if it is rate-limited, so it always returns a real price.

Parameters

Name	Type	Required	Description
`coin_id`	string	yes	Coin name, ticker, or coinpaprika ID (e.g., “bitcoin”, “BTC”, “btc-bitcoin”)

Example call

Arguments

{
  "coin_id": "bitcoin"
}

curl

curl -X POST https://gateway.pipeworx.io/crypto/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_crypto_price","arguments":{"coin_id":"bitcoin"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "coin_id": "ethereum"
}

Response shape

Always returns: id, symbol, price_usd

Field	Type	Description
`id`	string
`symbol`	string
`price_usd`	number \| string
`source`	string	Which upstream answered
`_fallback`	boolean	True when served from the fallback upstream
`_note`	string	Why the fallback was used
`name`	string	Coinpaprika path only
`market_cap_usd`	number \| null	Coinpaprika path only
`volume_24h_usd`	number \| null	Coinpaprika path only
`change_24h_pct`	number \| null	Coinpaprika path only
`high_24h_usd`	number \| null	Not returned by the current coinpaprika response; kept for back-compat
`low_24h_usd`	number \| null	Not returned by the current coinpaprika response; kept for back-compat
`rank`	number \| null	Market-cap rank; coinpaprika path only
`last_updated`	string	Upstream quote timestamp (ISO-8601); coinpaprika path only

Full JSON Schema

{
  "type": "object",
  "description": "Current price for a coin. Two shapes: the coinpaprika path carries name/rank/market-cap/volume/24h-change/last_updated; when coinpaprika is unavailable (it returns HTTP 402 when its quota is spent) the pack falls back to a coinbase spot price carrying only id/symbol/price_usd/source plus _fallback and _note. Only the three fields common to BOTH paths are required.",
  "properties": {
    "id": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "price_usd": {
      "type": [
        "number",
        "string"
      ]
    },
    "source": {
      "type": "string",
      "description": "Which upstream answered"
    },
    "_fallback": {
      "type": "boolean",
      "description": "True when served from the fallback upstream"
    },
    "_note": {
      "type": "string",
      "description": "Why the fallback was used"
    },
    "name": {
      "type": "string",
      "description": "Coinpaprika path only"
    },
    "market_cap_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coinpaprika path only"
    },
    "volume_24h_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coinpaprika path only"
    },
    "change_24h_pct": {
      "type": [
        "number",
        "null"
      ],
      "description": "Coinpaprika path only"
    },
    "high_24h_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Not returned by the current coinpaprika response; kept for back-compat"
    },
    "low_24h_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Not returned by the current coinpaprika response; kept for back-compat"
    },
    "rank": {
      "type": [
        "number",
        "null"
      ],
      "description": "Market-cap rank; coinpaprika path only"
    },
    "last_updated": {
      "type": "string",
      "description": "Upstream quote timestamp (ISO-8601); coinpaprika path only"
    }
  },
  "required": [
    "id",
    "symbol",
    "price_usd"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_crypto_price