Collections are used to represent all the assets in a single (or multiple) contract addresses and help users group items from the same creator. They have one or more owners and are typically associated with important metadata such as creator royalties and descriptions.

Field name

Description

name

The collection name. Typically derived from the first contract imported to the collection but can be changed by the user

external_link

External link to the original website for the collection

description

Description for the model

slug

The collection slug that is used to link to the collection on OpenSea. This value can change by the owner but must be unique across all collection slugs in OpenSea

image_url

An image for the collection. Note that this is the cached URL we store on our end. The original image url is image_original_url

banner_image_url

Image used in the horizontal top banner for the collection.

dev_seller_fee_basis_points

The collector's fees that get paid out to them when sales are made for their collections

safelist_request_status

The collection's approval status within OpenSea. Can be not_requested (brand new collections), requested (collections that requested safelisting on our site), approved (collections that are approved on our site and can be found in search results), and verified (verified collections)

payout_address

The payout address for the collection's royalties

primary_asset_contracts

A list of the contracts that are associated with this collection

traits

A dictionary listing all the trait types available within this collection

payment_tokens

The payment tokens accepted for this collection

editors

Approved editors on this collection.

stats

A dictionary containing some sales statistics related to this collection, including trade volume and floor prices