---
title: "Get distribution of the number of bids by price"
method: GET
path: "/v2.0/data/collections/{id}/bidsByPrice"
tags: ["Collection Statistics"]
---

# Get distribution of the number of bids by price

`GET /v2.0/data/collections/{id}/bidsByPrice`

## Request

- Base URL: `https://api.rarible.org`
- URL: `https://api.rarible.org/v2.0/data/collections/{id}/bidsByPrice`
- Auth: API key in header `X-API-KEY`

Returns list of bid prices with number of bids and bidders

## Path parameters

- `id` string, required: Collection id

## Query parameters

- `continuation` string
- `size` integer
- `sort` 'PRICE' | 'VOLUME_NATIVE'

## Response `200`

OK

- OlapBidsByPriceStatistics
  - `maxVolumeNative` number, required
  - `prices` OlapBidsByPrice[], required
    - `price` number, required
    - `bidsCount` integer, required
    - `volumeNative` number, required
    - `buyersCount` integer, required
    - `buyer` string: Blockchain address in Union format `${blockchainGroup}:${token}`
  - `continuation` string: Continuation token to paginate result

## Other responses

- `400`: Bad Request
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api.md) - [All operations](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rarible/apis/rarible-protocol-mcp-api/revisions/5d2651b9411d?raw)