Rarible

Rarible Collection Statistics API

The Collection Statistics API from Rarible — 7 operation(s) for collection statistics.

GitHub OpenAPI

Operations 7

GET /v2.0/data/collections/{id}/statistics/global Get global (period-independent) statistics by collection ID #
POST /v2.0/data/collections/statistics/global/byIds Get global (period-independent) statistics by collection IDs #
POST /v2.0/data/collections/statistics/aggregated Get NFT Collections aggregated statistics #
GET /v2.0/data/collections/{id}/statistics/period Get period-based statistics by collection ID #
POST /v2.0/data/collections/statistics/period/byIds Get period-based statistics by collection IDs #
GET /v2.0/data/collections/{id}/owners Get distribution of the number of owned items by owner #
GET /v2.0/data/collections/{id}/bidsByPrice Get distribution of the number of bids by price #

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-statistics-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-statistics-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-statistics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Collection Statistics 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 Statistics
  x-controller: CollectionStatisticsController
paths:
  /v2.0/data/collections/{id}/statistics/global:
    get:
      tags:
      - Collection Statistics
      summary: Get global (period-independent) statistics by collection ID
      description: Global collection statistics by ID
      operationId: getGlobalCollectionStatistics
      parameters:
      - name: id
        in: path
        description: Collection ID
        required: true
        schema:
          $ref: '#/components/schemas/CollectionId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapGlobalCollectionStatisticsResponse'
        '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/collections/statistics/global/byIds:
    post:
      tags:
      - Collection Statistics
      summary: Get global (period-independent) statistics by collection IDs
      description: Global collection statistics by IDs
      operationId: getGlobalCollectionStatisticsByIds
      requestBody:
        content:
          application/json:
            schema:
              type: array
              minItems: 1
              maxItems: 100
              items:
                $ref: '#/components/schemas/CollectionId'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OlapGlobalCollectionStatisticsResponse'
        '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/collections/statistics/aggregated:
    post:
      tags:
      - Collection Statistics
      summary: Get NFT Collections aggregated statistics
      description: Get aggregated statistics for collections list
      operationId: getCollectionsAggregatedStatistics
      requestBody:
        content:
          application/json:
            schema:
              type: array
              minItems: 1
              maxItems: 100
              items:
                $ref: '#/components/schemas/CollectionId'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapAggregatedCollectionStatisticsResponse'
              example:
                owners: 6472
                highestSaleUsd: 37.66
                volumeUsd: 37.66
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
  /v2.0/data/collections/{id}/statistics/period:
    get:
      tags:
      - Collection Statistics
      summary: Get period-based statistics by collection ID
      description: Period-based collection statistics by ID
      operationId: getPeriodCollectionStatistics
      parameters:
      - name: id
        in: path
        description: Collection ID
        required: true
        schema:
          $ref: '#/components/schemas/CollectionId'
      - name: period
        in: query
        description: Time period for aggregation
        required: true
        schema:
          $ref: '#/components/schemas/OlapPeriod'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapPeriodCollectionStatisticsResponse'
        '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/collections/statistics/period/byIds:
    post:
      tags:
      - Collection Statistics
      summary: Get period-based statistics by collection IDs
      description: Period-based collection statistics by IDs
      operationId: getPeriodCollectionStatisticsByIds
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OlapPeriodCollectionsByIdsStatisticsRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OlapPeriodCollectionStatisticsResponse'
        '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/collections/{id}/owners:
    get:
      tags:
      - Collection Statistics
      summary: Get distribution of the number of owned items by owner
      description: Returns list of owners of items in the collection along with the number of owned items
      operationId: getOwners
      parameters:
      - name: id
        in: path
        required: true
        description: Collection ID
        schema:
          $ref: '#/components/schemas/CollectionId'
      - name: continuation
        in: query
        required: false
        description: Continuation token from the previous response
        schema:
          type: string
      - name: size
        in: query
        required: false
        description: The number of results to return
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapOwnerStatistics'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
  /v2.0/data/collections/{id}/bidsByPrice:
    get:
      tags:
      - Collection Statistics
      summary: Get distribution of the number of bids by price
      description: Returns list of bid prices with number of bids and bidders
      operationId: getBidsByPrice
      parameters:
      - name: id
        in: path
        required: true
        description: Collection ID
        schema:
          $ref: '#/components/schemas/CollectionId'
      - name: continuation
        in: query
        required: false
        description: Continuation token from the previous response
        schema:
          type: string
      - name: size
        in: query
        required: false
        description: The number of results to return
        schema:
          type: integer
      - name: sort
        in: query
        required: false
        description: Result sorting
        schema:
          $ref: '#/components/schemas/OlapBidsByPriceSort'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapBidsByPriceStatistics'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OlapError'
components:
  schemas:
    OlapOwnerStatistics:
      type: object
      properties:
        owners:
          type: array
          items:
            $ref: '#/components/schemas/OlapOwnerStatistic'
        continuation:
          type: string
          description: Continuation token to paginate result
      required:
      - owners
    OlapGlobalCollectionStatisticsResponse:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/CollectionId'
        listed:
          type: integer
          format: int64
        items:
          type: integer
          format: int64
        owners:
          type: integer
          format: int64
        floor:
          $ref: '#/components/schemas/OlapPriceWithUsd'
        volume:
          description: Total worth of all transactions with items in this collection
          $ref: '#/components/schemas/OlapPriceWithUsd'
      required:
      - listed
      - items
      - owners
      - volume
    OlapBidsByPriceSort:
      type: string
      default: PRICE
      enum:
      - PRICE
      - VOLUME_NATIVE
    OlapAggregatedCollectionStatisticsResponse:
      required:
      - highestSaleUsd
      - owners
      - volumeUsd
      type: object
      properties:
        highestSaleUsd:
          description: Highest worth transaction in all collections
          type: number
          format: bigdecimal
        volumeUsd:
          description: Total worth of all transactions were made with nfts in collections
          type: number
          format: bigdecimal
        owners:
          type: integer
          description: Current amount of unique owners who hold nfts in collections
          format: int32
    OlapError:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
          description: Code
          enum:
          - INVALID_INPUT
          - NOT_FOUND
          - UNKNOWN
        message:
          type: string
          description: Message
    OlapPeriodCollectionsByIdsStatisticsRequest:
      type: object
      properties:
        collectionIds:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: string
        period:
          $ref: '#/components/schemas/OlapPeriod'
      required:
      - collectionIds
      - period
    OlapBidsByPrice:
      type: object
      properties:
        price:
          type: number
          format: bigdecimal
        bidsCount:
          type: integer
          format: int64
        volumeNative:
          type: number
          format: bigdecimal
        buyersCount:
          type: integer
          format: int64
        buyer:
          $ref: '#/components/schemas/UnionAddress'
      required:
      - price
      - bidsCount
      - volumeNative
      - volumeRatio
      - buyersCount
    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
    OlapPeriodCollectionStatisticsResponse:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/CollectionId'
        period:
          $ref: '#/components/schemas/OlapPeriod'
        volume:
          description: Period (e.g., 1-day) worth of all transactions with items in this collection
          $ref: '#/components/schemas/OlapPriceWithUsd'
        floorChangePercent:
          description: Change in floor price in percent during the period.
          type: number
          format: bigdecimal
      required:
      - period
      - volume
    OlapOwnerStatistic:
      type: object
      properties:
        owner:
          $ref: '#/components/schemas/UnionAddress'
        ownedItems:
          type: integer
          format: int64
      required:
      - owner
      - ownedItems
    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"
    CollectionId:
      type: string
      description: Collection id
      example: ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8
    OlapBidsByPriceStatistics:
      type: object
      properties:
        maxVolumeNative:
          type: number
          format: bigdecimal
        prices:
          type: array
          items:
            $ref: '#/components/schemas/OlapBidsByPrice'
        continuation:
          type: string
          description: Continuation token to paginate result
      required:
      - prices
      - maxVolumeNative
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      x-default: 11111111-1111-1111-1111-111111111111