Rarible

Rarible Collection Leader Board API

The Collection Leader Board API from Rarible — 2 operation(s) for collection leader board.

GitHub OpenAPI

Operations 2

GET /v2.0/data/leaderboard/collections Get NFT Collections leaderboard #
GET /v2.0/data/leaderboard/collections/byOwner Get NFT Collections leaderboard for a specific owner addresses #

Documentation

📖
Documentation
https://docs.rarible.org/docs/introduction
📖
Authentication
https://docs.rarible.org/docs/authentication
📖
Documentation
https://docs.rarible.org/docs/data-analytics

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/rarible/refs/heads/main/openapi/rarible-collection-leader-board-api-openapi.yml

Other Resources

🔗
Signup
https://rarible.org/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/rarible-collection-leader-board-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

rarible-collection-leader-board-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Collection Leader Board API
  version: v0.1
  description: '# Exciting News


    Hey there, amazing developers!'
servers:
- url: https://{environment}.rarible.org
  description: Production (Mainnet)
  variables:
    environment:
      enum:
      - api
      - testnet-api
      default: api
security:
- ApiKeyAuth: []
tags:
- name: Collection Leader Board
  x-controller: CollectionLeaderboardController
paths:
  /v2.0/data/leaderboard/collections:
    get:
      tags:
      - Collection Leader Board
      summary: Get NFT Collections leaderboard
      description: Collections leaderboard
      operationId: getCollectionLeaderboard
      parameters:
      - name: blockchains
        in: query
        description: Blockchain networks
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/OlapBlockchain'
      - name: period
        in: query
        description: Time period for aggregation
        required: false
        schema:
          $ref: '#/components/schemas/OlapPeriod'
      - name: sort
        in: query
        description: Collections sorting
        required: false
        schema:
          $ref: '#/components/schemas/OlapLeaderboardSort'
      - name: direction
        in: query
        description: Collections sorting direction
        required: false
        schema:
          $ref: '#/components/schemas/OlapLeaderboardSortDirection'
      - name: limit
        in: query
        description: Limit of records in leaderboard
        required: false
        schema:
          type: integer
          format: int32
          default: 10
      - name: offset
        in: query
        description: Offset reference
        required: false
        schema:
          type: integer
          format: int32
          default: 0
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapCollectionLeaderboardResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
  /v2.0/data/leaderboard/collections/byOwner:
    get:
      tags:
      - Collection Leader Board
      summary: Get NFT Collections leaderboard for a specific owner addresses
      description: User collections leaderboard
      operationId: getCollectionLeaderboardByOwner
      parameters:
      - name: owners
        in: query
        required: true
        description: Addresses of the owner
        schema:
          type: array
          items:
            $ref: '#/components/schemas/UnionAddress'
      - name: blockchains
        in: query
        description: Blockchain networks
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/OlapBlockchain'
      - name: period
        in: query
        description: Time period for aggregation
        required: false
        schema:
          $ref: '#/components/schemas/OlapPeriod'
      - name: sort
        in: query
        description: Collections sorting
        required: false
        schema:
          $ref: '#/components/schemas/OlapLeaderboardSort'
      - name: direction
        in: query
        description: Collections sorting direction
        required: false
        schema:
          $ref: '#/components/schemas/OlapLeaderboardSortDirection'
      - name: limit
        in: query
        description: Limit of records in leaderboard
        required: false
        schema:
          type: integer
          format: int32
          default: 10
      - name: continuation
        in: query
        required: false
        description: Continuation token from the previous response
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapCollectionLeaderboardResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
components:
  schemas:
    OlapHistoryValuesByTimestamps:
      required:
      - timestamps
      - values
      type: object
      properties:
        timestamps:
          type: array
          description: Timestamps of historical statistics
          items:
            type: integer
            format: int64
            description: Unix epoch of historical statistics
        values:
          type: array
          description: Values of historical statistics
          items:
            type: number
            description: Value of historical statistics
            format: bigdecimal
    OlapCollectionLeaderboardResponse:
      type: object
      properties:
        continuation:
          type: string
        result:
          type: array
          items:
            $ref: '#/components/schemas/OlapCollectionLeaderboardItem'
    OlapError:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
          description: Code
          enum:
          - INVALID_INPUT
          - NOT_FOUND
          - UNKNOWN
        message:
          type: string
          description: Message
    OlapBlockchain:
      type: string
      enum:
      - ETHEREUM
      - POLYGON
      - SOLANA
      - ARBITRUM
      - CHILIZ
      - LIGHTLINK
      - ZKSYNC
      - BASE
      - RARI
      - APTOS
      - ZKLINK
      - QUAI
      - ECLIPSE
      - ELECTRONEUM
      - SAAKURU
      - OASIS
      - MATCH
      - MOONBEAM
      - ETHERLINK
      - ZKCANDY
      - BERACHAIN
      - ABSTRACT
      - SHAPE
      - TELOS
      - HEDERAEVM
      - VICTION
      - SETTLUS
      - GOAT
      - HYPEREVM
      - MEGAETH
      - MEGAETHTESTNET
      - MEGAETHTESTNETV2
      - BASECAMP
      - CAMP
      - SOMNIA
      - ARENAZ
      - INJECTIVE
      - INJECTIVETESTNET
      - APECHAIN
      - BLOCKCHAINKEK
      - STELLAR
      - ZILLIQA
      - FRAXTAL
      - XLAYER
      - MONAD
    OlapLeaderboardSort:
      type: string
      default: VOLUME
      enum:
      - VOLUME
      - VOLUME_CHANGE
      - FLOOR
      - FLOOR_CHANGE
      - SALES
      - SALES_CHANGE
      - LISTED
      - OWNERS
    OlapPriceWithUsd:
      required:
      - currency
      - value
      type: object
      properties:
        currency:
          type: string
        value:
          type: number
          description: Amount of currency
          format: bigdecimal
        valueUsd:
          type: number
          description: Amount in USD
          format: bigdecimal
    OlapCollectionLeaderboardStatistics:
      type: object
      required:
      - listed
      - items
      - owners
      properties:
        listed:
          type: integer
          format: int64
        items:
          type: integer
          format: int64
        owners:
          type: integer
          format: int64
        floor:
          $ref: '#/components/schemas/OlapPriceWithUsd'
        topOffer:
          $ref: '#/components/schemas/OlapPriceWithUsd'
    UnionAddress:
      type: string
      description: Blockchain address in Union format `${blockchainGroup}:${token}`
      example: ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb
    OlapPeriod:
      type: string
      enum:
      - MIN5
      - MIN30
      - H1
      - H6
      - D1
      - D7
      - D30
      - D180
      - D365
      - ALL
      description: "Period:\n  * `MIN5` - Last 5 minutes\n  * `MIN30` - Last 30 minutes\n  * `H1` - Last 1 hour\n  * `H6` - Last 6 hours\n  * `D1` - Last 1 day\n  * `D7` - Last 7 days\n  * `D30` - Last 30 days\n  * `D180` - Last 180 days (roughly 6 months)\n  * `D365` - Last 365 days (roughly 1 year)\n  * `ALL` - For all time\n"
    OlapCollectionLeaderboardItem:
      required:
      - id
      - sales
      - volume
      - floorHistory
      - globalStats
      type: object
      properties:
        id:
          type: string
          description: Identifier of collection
        sales:
          type: integer
          format: int64
        volume:
          $ref: '#/components/schemas/OlapPriceWithUsd'
        floorChangePercent:
          type: number
          format: bigdecimal
        floorHistory:
          $ref: '#/components/schemas/OlapHistoryValuesByTimestamps'
        globalStats:
          $ref: '#/components/schemas/OlapCollectionLeaderboardStatistics'
    OlapLeaderboardSortDirection:
      type: string
      default: DESC
      enum:
      - ASC
      - DESC
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      x-default: 11111111-1111-1111-1111-111111111111