Docs menu

OpenSea API endpoint

List ranked OpenSea collections API

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.

GETapiKey2 credits/requestOpenSeaopensea.rankingsResponseDoc/opensea/rankings

Endpoint facts

Method: GET
API path: /opensea/rankings
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: OpenSea
Response schema: #/definitions/opensea.rankingsResponseDoc

OpenSea API Try List ranked OpenSea collections API in Playground OpenSea API documentation

How this endpoint behaves

Query parameters:

ranking (optional): one of TOP, TRENDING, NEW. Default TRENDING
timeframe (optional): one of ONE_HOUR, ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ALL_TIME. Default ONE_DAY
limit (optional): collections per page, 1-100, default 20
cursor (optional): opaque pagination cursor taken from a previous response's next_page_cursor

An unrecognized ranking or timeframe is rejected with 400.

Live monitoring

Monitored request: GET /opensea/rankings?limit=3&ranking=TRENDING&timeframe=ONE_DAY
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.88 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /opensea/rankings?limit=20&ranking=TRENDING&timeframe=ONE_DAY
Items in collections: 20
Fields filled in every checked item: 2

Field	Filled in, of 20 checked	Values in the sample
score	20	6.39 to 25.74, median 9.59
collection	20

Request parameters

Parameter	Type	Required	Description
ranking	string	No	Ranking board Allowed values: TOP, TRENDING, NEW.
timeframe	string	No	Ranking window Allowed values: ONE_HOUR, ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ALL_TIME.
limit	integer	No	Collections per page, 1-100
cursor	string	No	Opaque pagination cursor from a previous next_page_cursor
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opensea/rankings?ranking=TOP&timeframe=ONE_HOUR&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "ranking": "TRENDING",
    "timeframe": "ONE_DAY",
    "collections": [
      {
        "score": "28.3713030851",
        "collection": {
          "id": "bd5f48029bac4f7faee5b1e334c31a2b",
          "slug": "chain-mancers",
          "name": "Chain Mancers",
          "is_verified": true,
          "floor_price": {
            "amount": 0.0189,
            "currency": "ETH",
            "usd": 46.4
          },
          "stats": {
            "sales": 4211,
            "total_supply": 10000,
            "unique_item_count": 9997,
            "listed_item_count": 612,
            "volume_native": 1893.25,
            "volume_usd": 3697279.86,
            "volume_currency": "ETH",
            "one_day": {
              "sales": 812,
              "volume_native": 94.1,
              "volume_usd": 231160.3,
              "floor_price_change": 0.0759
            }
          }
        }
      }
    ],
    "next_page_cursor": "WzIwXQ"
  }
}

Request schema

No body schema

Response schema

#/definitions/opensea.rankingsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	opensea.RankingsResponse	No
data.collections	array	No
data.collections[].collection	opensea.CollectionSummary	No		CollectionSummary record, 46 fields: category, chain, contract_address, floor_price, id, image_url, is_verified, markets, name, slug, stats. Described under OpenSea Collection Search API.
data.collections[].score	string	No	28.3713030851
data.next_page_cursor	string	No
data.ranking	string	No	TRENDING
data.timeframe	string	No	ONE_DAY
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/opensea/rankings?ranking=TOP&timeframe=ONE_HOUR&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More OpenSea endpoint docs OpenSea API OpenSea Marketplace Activity API documentation List OpenSea's browse categories API documentation List the chains OpenSea indexes API documentation Get an OpenSea collection API documentation OpenSea Collection Activity API documentation OpenSea Collection Best Deals API documentation

Open in Playground Back to group

Docs menu

OpenSea API endpoint

List ranked OpenSea collections API

GETapiKey2 credits/requestOpenSeaopensea.rankingsResponseDoc/opensea/rankings

Endpoint facts

Method: GET
API path: /opensea/rankings
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: OpenSea
Response schema: #/definitions/opensea.rankingsResponseDoc

OpenSea API Try List ranked OpenSea collections API in Playground OpenSea API documentation

How this endpoint behaves

Query parameters:

ranking (optional): one of TOP, TRENDING, NEW. Default TRENDING
timeframe (optional): one of ONE_HOUR, ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ALL_TIME. Default ONE_DAY
limit (optional): collections per page, 1-100, default 20
cursor (optional): opaque pagination cursor taken from a previous response's next_page_cursor

An unrecognized ranking or timeframe is rejected with 400.

Live monitoring

Monitored request: GET /opensea/rankings?limit=3&ranking=TRENDING&timeframe=ONE_DAY
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.88 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /opensea/rankings?limit=20&ranking=TRENDING&timeframe=ONE_DAY
Items in collections: 20
Fields filled in every checked item: 2

Field	Filled in, of 20 checked	Values in the sample
score	20	6.39 to 25.74, median 9.59
collection	20

Request parameters

Parameter	Type	Required	Description
ranking	string	No	Ranking board Allowed values: TOP, TRENDING, NEW.
timeframe	string	No	Ranking window Allowed values: ONE_HOUR, ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ALL_TIME.
limit	integer	No	Collections per page, 1-100
cursor	string	No	Opaque pagination cursor from a previous next_page_cursor
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opensea/rankings?ranking=TOP&timeframe=ONE_HOUR&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "ranking": "TRENDING",
    "timeframe": "ONE_DAY",
    "collections": [
      {
        "score": "28.3713030851",
        "collection": {
          "id": "bd5f48029bac4f7faee5b1e334c31a2b",
          "slug": "chain-mancers",
          "name": "Chain Mancers",
          "is_verified": true,
          "floor_price": {
            "amount": 0.0189,
            "currency": "ETH",
            "usd": 46.4
          },
          "stats": {
            "sales": 4211,
            "total_supply": 10000,
            "unique_item_count": 9997,
            "listed_item_count": 612,
            "volume_native": 1893.25,
            "volume_usd": 3697279.86,
            "volume_currency": "ETH",
            "one_day": {
              "sales": 812,
              "volume_native": 94.1,
              "volume_usd": 231160.3,
              "floor_price_change": 0.0759
            }
          }
        }
      }
    ],
    "next_page_cursor": "WzIwXQ"
  }
}

Request schema

No body schema

Response schema

#/definitions/opensea.rankingsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	opensea.RankingsResponse	No
data.collections	array	No
data.collections[].collection	opensea.CollectionSummary	No		CollectionSummary record, 46 fields: category, chain, contract_address, floor_price, id, image_url, is_verified, markets, name, slug, stats. Described under OpenSea Collection Search API.
data.collections[].score	string	No	28.3713030851
data.next_page_cursor	string	No
data.ranking	string	No	TRENDING
data.timeframe	string	No	ONE_DAY
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/opensea/rankings?ranking=TOP&timeframe=ONE_HOUR&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

List ranked OpenSea collections API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

List ranked OpenSea collections API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related