---
title: "Aggregated price for a single symbol"
method: GET
path: "/api/v1/prices/{symbol}"
tags: ["prices"]
---

# Aggregated price for a single symbol

`GET /api/v1/prices/{symbol}`

## Request

- Base URL: `https://api.bitcompare.net`
- URL: `https://api.bitcompare.net/api/v1/prices/{symbol}`
- Auth: one of:
  - none
  - HTTP bearer

Aggregated exchange price for one symbol, plus the raw per-provider prices that fed the aggregate. Use get_price for multiple symbols in one call.

## Path parameters

- `symbol` string, required: Single coin symbol, e.g. "btc"

## Response `200`

Successful response

- object
  - `data` object, required
    - `symbol` string, required
    - `aggregated` object, required
      - `symbol` string, required: Coin symbol
      - `price` number, required: Aggregated price in `currency` (default USD)
      - `currency` string, required: ISO 4217 currency code the price is denominated in
      - `providers` integer, required: Number of providers included in the aggregation
      - `min` number, required: Lowest provider price after outlier filtering
      - `max` number, required: Highest provider price after outlier filtering
      - `median` number, required: Median provider price
      - `timestamp` string, required: ISO-8601 timestamp of the aggregation
    - `providers` object[], required: Per-provider prices that fed the aggregate
      - `provider` string, required
      - `symbol` string, required
      - `price` number, required
      - `category` string, required
      - `updatedAt` string, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Plan rate limit exceeded — see X-RateLimit-* headers and Retry-After

---

[API](https://skmtc.dev/bitcompare/apis/bitcompare-api.md) · [All operations](https://skmtc.dev/bitcompare/apis/bitcompare-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitcompare/apis/bitcompare-api/revisions/936dfbf752d2?raw)