---
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`

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.net/rarible/apis/openapi-definition.md) · [All operations](https://skmtc.net/rarible/apis/openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rarible/openapi-definition/revisions/5d2651b9411d/schema)