> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_crypto_prices

# get_crypto_prices

> Live prices for named coins or the top of the market: price, 24-hour change, market cap and volume. ₹0.13 per call; a result that finds nothing is ₹0.

## What it does

Current prices for a list of coins, or the top coins by market cap when none are named: data with one row per coin carrying rank, name, symbol, price in the chosen currency, 24-hour change in percent, 24-hour high and low, market cap, 24-hour volume, all-time high and the update time.

Use it to give an agent a price in a chat, to log a portfolio or to watch the market; [`get_finance_quote`](https://parel.si/docs/tools/get_finance_quote.md) does the same for stocks and indices. Prices are fresh to about a minute; this is information, not advice. Flat price per call; an unknown coin id is free. Under two seconds.

India: currency "inr" quotes in rupees.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `coins` | string | no | Comma-separated coin ids (bitcoin,ethereum,solana), or empty for the top coins by market cap. |
| `limit` | integer | no | How many coins when coins is empty, up to 100. Default 20.; max 100 |
| `currency` | string | no | Quote currency (usd, inr, eur). Default usd. |

## What drives the cost

Flat per call for up to 100 coins. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.13** per call (`cost_paise: 13`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_crypto_prices"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_crypto_prices"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_crypto_prices","input":{"coins":"bitcoin,ethereum,solana","currency":"inr"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
[
  {
    "ath": 11187013,
    "change_24h": -3.01719,
    "high_24h": 7641237,
    "low_24h": 7357563,
    "market_cap": 147820541377688,
    "name": "Bitcoin",
    "price": 7352293,
    "rank": 1,
    "symbol": "BTC",
    "updated": "2026-11-05T15:04:50.000Z",
    "volume_24h": 3239795576844
  },
  {
    "ath": 431946,
    "change_24h": -4.21896,
    "high_24h": 230788,
    "low_24h": 220072,
    "market_cap": 26873034314900,
    "name": "Ethereum",
    "price": 219925,
    "rank": 2,
    "symbol": "ETH",
    "updated": "2026-11-05T15:04:50.000Z",
    "volume_24h": 1355050511111
  },
  {
    "ath": 25396,
    "change_24h": -5.15767,
    "high_24h": 9181.18,
    "low_24h": 8748.88,
    "market_cap": 5157647192484,
    "name": "Solana",
    "price": 8737.07,
    "rank": 7,
    "symbol": "SOL",
    "updated": "2026-11-05T15:04:50.000Z",
    "volume_24h": 412540514760
  }
]
```

## Notes

- Flat per call for up to 100 coins.
- currency inr for rupee quotes; coin ids are lower-case names (bitcoin, ethereum).
- Fresh to about a minute; not a trading feed.

## Siblings

- [`get_finance_quote`](https://parel.si/docs/tools/get_finance_quote.md)
