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
- Get Events (by account) pagination fixed
- Get Events endpoints
limit
parameter fixed
- NFT API
- Get Collection returns two new fields:
total_supply
(minted minus burned) andcreated_date
- Get Contract response field
supply
renamed tototal_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 fortotalSupply()
- Get Account and Get Collection fixed returning twitter and instagram usernames
- Get Collection returns two new fields:
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 annft
fieldcancel
events now have the following fields:nft
,order_type
, andmaker
- note: API now returns both canceled listings and canceled offers when querying for
event_type=cancel
- note: API now returns both canceled listings and canceled offers when querying for
event
paymentquantity
now returns as a string instead of a number (for compatibility with JavaScript)- general purpose Get Events endpoint added
- all events now have an
- 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
- added
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.