---
title: "Get NFT Collections leaderboard for a specific owner adresses"
method: GET
path: "/v2.0/data/leaderboard/collections/byOwner"
tags: ["Collection Leader Board"]
---

# Get NFT Collections leaderboard for a specific owner adresses

`GET /v2.0/data/leaderboard/collections/byOwner`

## Request

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

User collections leaderboard

## Query parameters

- `owners` UnionAddress[], required
- `blockchains` OlapBlockchain[]
- `period` 'MIN5' | 'MIN30' | 'H1' | 'H6' | 'D1' | 'D7' | 'D30' | 'D180' | 'D365' | 'ALL': 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
- `sort` 'VOLUME' | 'VOLUME_CHANGE' | 'FLOOR' | 'FLOOR_CHANGE' | 'SALES' | 'SALES_CHANGE' | 'LISTED' | 'OWNERS'
- `direction` 'ASC' | 'DESC'
- `limit` integer
- `continuation` string

## Response `200`

OK

- OlapCollectionLeaderboardResponse
  - `continuation` string
  - `result` OlapCollectionLeaderboardItem[]
    - `id` string, required: Identifier of collection
    - `sales` integer, required
    - `volume` OlapPriceWithUsd, required
      - `currency` string, required
      - `value` number, required: Amount of currency
      - `valueUsd` number: Amount in USD
    - `floorChangePercent` number
    - `floorHistory` OlapHistoryValuesByTimestamps, required
      - `timestamps` integer[], required: Timestamps of historical statistics
      - `values` number[], required: Values of historical statistics
    - `globalStats` OlapCollectionLeaderboardStatistics, required
      - `listed` integer, required
      - `items` integer, required
      - `owners` integer, required
      - `floor` OlapPriceWithUsd
        - `currency` string, required
        - `value` number, required: Amount of currency
        - `valueUsd` number: Amount in USD
      - `topOffer` OlapPriceWithUsd
        - `currency` string, required
        - `value` number, required: Amount of currency
        - `valueUsd` number: Amount in USD

## 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)