---
title: "Get prices"
method: GET
path: "/api/v1/prices"
tags: ["Prices"]
---

# Get prices

`GET /api/v1/prices`

Prices for a requested set of coins. Pass at least one selector — `ids`, `slugs`
or `symbols` (up to 100 combined). `meta.currency` echoes the conversion target
(USD unless `convert` is set).

## Query parameters

- `ids` string, nullable — Coin ids to price (CSV). At least one of ids, slugs or symbols is required; the three lists cap at 100 selectors combined. This field is required when none of <code>slugs</code> and <code>symbols</code> are present. Must not be greater than 1000 characters.
- `slugs` string, nullable — Coin slugs to price (CSV). At least one of ids, slugs or symbols is required. This field is required when none of <code>ids</code> and <code>symbols</code> are present. Must not be greater than 2000 characters.
- `symbols` string, nullable — Coin symbols to price (CSV, case-insensitive). At least one of ids, slugs or symbols is required. This field is required when none of <code>ids</code> and <code>slugs</code> are present. Must not be greater than 1000 characters.
- `convert` 'USD' | 'EUR' | 'JPY' | 'BGN' | 'CZK' | 'DKK' | 'GBP' | 'HUF' | 'PLN' | 'RON' | 'SEK' | 'CHF' | 'ISK' | 'NOK' | 'HRK' | 'RUB' | 'TRY' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'HKD' | 'IDR' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'MYR' | 'NZD' | 'PHP' | 'SGD' | 'THB' | 'ZAR' | 'ARS' | 'DZD' | 'MAD' | 'TWD', nullable — Convert prices/marketcap into an active fiat currency by symbol (default USD). FX rates refresh ~twice daily.

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `slug` string
    - `symbol` string
    - `name` string
    - `rank` integer
    - `price` string
    - `marketcap` number
    - `volume_24h` integer
    - `change_24h` number
    - `change_7d` number
    - `change_rank_24h` integer
    - `change_rank_7d` integer
    - `last_updated` string
  - `meta` object
    - `currency` string
    - `count` integer

## Other responses

- `422`

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/versions/ed1378af68b6/schema)