# OpenSea Collection Rankings API Documentation

<p><strong>OpenSea Collection Rankings API Documentation</strong> List public OpenSea collections ranked by period and type. Each row has a score, collection slug and name, floor price, top offer and full stats with owners, sales, supply, listed items and volume. Filter by period and type TRENDING or TOP. Pass after from the previous response for the next page. A chain or sort_by filter returns 422. An empty answer and every failed request cost no credit. Cost: 1 credit per successful request. Scrappa is an independent service and is not affiliated with or endorsed by OpenSea.</p>

- **Documentation:** [https://scrappa.co/docs/opensea-api/opensea_rankings](https://scrappa.co/docs/opensea-api/opensea_rankings)
- **API group:** OpenSea API
- **Endpoint:** `GET https://scrappa.co/api/opensea/collections/rankings`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `period` | string | No | ONE_HOUR, ONE_DAY (default), SEVEN_DAYS, THIRTY_DAYS or ALL_TIME. |
| `type` | string | No | TRENDING (default) or TOP. |
| `limit` | integer | No | Rows per page, 1 to 100. |
| `after` | string | No | Cursor from the previous response. |

## Example response

```json
{
    "data": {
        "type": "TRENDING",
        "period": "ONE_DAY",
        "rankings": [
            {
                "name": "Courtyard.io",
                "slug": "courtyard-nft",
                "score": 100,
                "collection": {
                    "name": "Courtyard.io",
                    "slug": "courtyard-nft"
                }
            }
        ],
        "pagination": {
            "limit": 20,
            "has_more": true
        }
    },
    "meta": {
        "source": "opensea",
        "credits": 1,
        "billable": true,
        "endpoint_family": "gql_web"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A filter is missing or not supported. This response is not billable. |
| 502 | Bad Gateway | The public data is temporarily unavailable. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
