---
title: "Get an OpenSea collection"
method: GET
path: "/opensea/collection/{slug}"
tags: ["OpenSea"]
---

# Get an OpenSea collection

`GET /opensea/collection/{slug}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/opensea/collection/{slug}`
- Auth: API key in header `x-api-key`

Returns public marketplace metadata and trading statistics for one NFT collection: name, description, imagery, verification flag, contract address and chain, social links, current floor price and top collection offer, plus lifetime and rolling one-hour/one-day/seven-day/thirty-day sales, volume, and floor-price change. Delisted and blacklisted collections return 404 rather than an empty payload.

## Path parameters

- `slug` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- OpenseaCollectionResponseDoc
  - `code` integer
  - `data` OpenseaCollection
    - `banner_image_url` string
    - `category` string
    - `chain` string
    - `contract_address` string
    - `created_at` string
    - `description` string
    - `discord_url` string
    - `external_url` string
    - `floor_price` OpenseaPrice
      - `amount` number
      - `chain` string
      - `contract_address` string
      - `currency` string
      - `usd` number
    - `id` string
    - `image_url` string
    - `instagram_username` string
    - `is_verified` boolean
    - `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
    - `top_offer` OpenseaPrice
      - `amount` number
      - `chain` string
      - `contract_address` string
      - `currency` string
      - `usd` number
    - `twitter_username` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/028417aa35bb?raw)