---
title: "Get period-based statistics by collection IDs"
method: POST
path: "/v2.0/data/collections/statistics/period/byIds"
tags: ["Collection Statistics"]
---

# Get period-based statistics by collection IDs

`POST /v2.0/data/collections/statistics/period/byIds`

## Request

- Base URL: `https://api.rarible.org`
- URL: `https://api.rarible.org/v2.0/data/collections/statistics/period/byIds`
- Auth: API key in header `X-API-KEY`

Period-based collection statistics by IDs

## Request body

- OlapPeriodCollectionsByIdsStatisticsRequest
  - `collectionIds` string[], required
  - `period` 'MIN5' | 'MIN30' | 'H1' | 'H6' | 'D1' | 'D7' | 'D30' | 'D180' | 'D365' | 'ALL', required: Period: * `MIN5` - Last 5 minutes * `MIN30` - Last 30 minutes * `H1` - Last 1 hour * `H6` - Last 6 hours * `D1` - Last 1 day * `D7` - Last 7 days * `D30` - Last 30 days * `D180` - Last 180 days (roughly 6 months) * `D365` - Last 365 days (roughly 1 year) * `ALL` - For all time

## Response `200`

OK

- OlapPeriodCollectionStatisticsResponse[]
  - `id` string: Collection id
  - `period` 'MIN5' | 'MIN30' | 'H1' | 'H6' | 'D1' | 'D7' | 'D30' | 'D180' | 'D365' | 'ALL', required: Period: * `MIN5` - Last 5 minutes * `MIN30` - Last 30 minutes * `H1` - Last 1 hour * `H6` - Last 6 hours * `D1` - Last 1 day * `D7` - Last 7 days * `D30` - Last 30 days * `D180` - Last 180 days (roughly 6 months) * `D365` - Last 365 days (roughly 1 year) * `ALL` - For all time
  - `volume` OlapPriceWithUsd, required
    - `currency` string, required
    - `value` number, required: Amount of currency
    - `valueUsd` number: Amount in USD
  - `floorChangePercent` number: Change in floor price in percent during the period.

## Other responses

- `400`: Bad Request
- `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)
