---
title: "List ranked OpenSea collections"
method: GET
path: "/opensea/rankings"
tags: ["OpenSea"]
---

# List ranked OpenSea collections

`GET /opensea/rankings`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/opensea/rankings`
- Auth: API key in header `x-api-key`

Returns the collections on one of OpenSea's ranking boards for a given window, each with its ranking score, floor price, and rolling stats. `TRENDING` ranks by recent momentum, `TOP` by absolute volume, and `NEW` surfaces recently launched collections.

## Query parameters

- `ranking` 'TOP' | 'TRENDING' | 'NEW'
- `timeframe` 'ONE_HOUR' | 'ONE_DAY' | 'SEVEN_DAYS' | 'THIRTY_DAYS' | 'ALL_TIME'
- `limit` integer
- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- OpenseaRankingsResponseDoc
  - `code` integer
  - `data` OpenseaRankingsResponse
    - `collections` OpenseaRankedCollection[]
      - `collection` OpenseaCollectionSummary
        - `category` string
        - `chain` string
        - `contract_address` string
        - `floor_price` OpenseaPrice
          - `amount` number
          - `chain` string
          - `contract_address` string
          - `currency` string
          - `usd` number
        - `id` string
        - `image_url` string
        - `is_verified` boolean
        - `markets` OpenseaMarketListing[]
          - `listed_item_count` integer
          - `marketplace` string
          - `name` string
        - `name` string
        - `slug` string
        - `stats` OpenseaCollectionStats
          - `listed_item_count` integer
          - `one_day` OpenseaWindowStats
            - `floor_price_change` number
            - `sales` integer
            - `volume_native` number
            - `volume_usd` number
          - `one_hour` OpenseaWindowStats
            - `floor_price_change` number
            - `sales` integer
            - `volume_native` number
            - `volume_usd` number
          - `sales` integer
          - `seven_days` OpenseaWindowStats
            - `floor_price_change` number
            - `sales` integer
            - `volume_native` number
            - `volume_usd` number
          - `thirty_days` OpenseaWindowStats
            - `floor_price_change` number
            - `sales` integer
            - `volume_native` number
            - `volume_usd` number
          - `total_supply` integer
          - `unique_item_count` integer
          - `volume_currency` string
          - `volume_native` number
          - `volume_usd` number
      - `score` string
    - `next_page_cursor` string
    - `ranking` string
    - `timeframe` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)