Now Accepting Seaport v1.6 Orders

Starting today, OpenSea is migrating to Seaport v1.6. There are no interface changes to Seaport, so the methods and events are the same. As a developer, you just need to update to the latest SDK versions to create and submit orders using Seaport v1.6:

12.22.2023 Updates

  • New SDK Releases: <https://github.com/ProjectOpenSea/opensea-js/releases>
    • v7.0.5: replaces Optimism Goerli (deprecated) with Optimism Sepolia
    • v7.0.4: replaces Base Goerli (deprecated) with Base Sepolia
    • v7.0.3: fixes bug in returning errors from API responses
  • Events (Analytics) API
  • NFT API
    • Get Collection returns two new fields:total_supply (minted minus burned) and created_date
    • Get Contract response field supply renamed to total_supply, added note to the description of the field that this value only returns the value provided from the contract if the contract has a getter for totalSupply()
    • Get Account and Get Collection fixed returning twitter and instagram usernames

12.12.2023 Updates

  • New Major Version SDK Release (v7.0.0): <https://github.com/ProjectOpenSea/opensea-js/releases/tag/v7.0.0>
  • Rate Limits: doubled default rate limits for /v2
  • Events (Analytics) API
    • all events now have an event_timestamp (posix timestamp at which the event occured on the blockchain)
    • transfer events now have an nft field
    • cancel events now have the following fields: nft, order_type, and maker
      • note: API now returns both canceled listings and canceled offers when querying for event_type=cancel
    • event payment quantity now returns as a string instead of a number (for compatibility with JavaScript)
    • general purpose Get Events endpoint added
  • NFT API
    • added an endpoint for getting payment tokens (has both USD and ETH price for the token)
    • added opensea_url to the NFT model
    • added valid payment_tokens to the collection response
  • Marketplace API
    • added price object to offers

New Release: Best Offer and Best Listing Endpoints

Today, we are launching two new endpoints: one endpoint to get the highest bid for an NFT and one endpoint to get the cheapest listing for an NFT.

API V2 Fully Supported

Over the past 3 months, OpenSea has been closing the feature disparity between the V1 and V2 API. The V2 API is superior to V1 in many ways including:

NFT Image URL Changes

Previously, OpenSea had been returning the OpenSea CDN url in NFT responses. One example is the List NFT endpoints which returned the NFT Model which included image_url. Going forward, the image_url field returned when listing NFTs, is deprecated.

OpenSea Fees

There is a new guide created to help developers have clear instructions on what fees are required and how to set them when creating an order via the OpenSea API.

Chain Field added to Event Stream

We've recently added a top level chain field to most event payloads from the Stream API to make it easy to identify which chain the NFT or Collection affected by the event is on. The field has been added to following events:

Define The Standard for NFT Redeemables

At OpenSea, we believe in the continuing extensibility of NFT functionality and hope to continue to innovate with the community. There have been many new developments since ERC-721 was introduced in 2018, like ERC-1155 which introduced the notion of semi-fungible tokens. Today, we’re pleased to share ERC-7498 as a new standard for NFT redeemables.

BNB NFT Orders Disabled

Starting today, you will no longer be able to create new listings for or make new offers on BNB Smart Chain (BSC) NFTs.