The Element Stream API is a websocket-based service that enables developers to receive events as they occur, ensuring that your service has the most up-to-date details without the need to continuously poll for updates. Currently Stream API, your service can subscribe to receive different types of order events, you can subscribe according to the chain and the market.
The Stream API currently supports the following set of events:
- Item minted - item created
- Item listed - an item listed for sale on the Element marketplace
- Item sold - sale of an item on the Element marketplace
- Item cancel - cancellation of an ask order on the Element marketplace
- Item bid cancel - cancellation of an offer order on the Element marketplace
- Item received offer - offer received on an item in the Element marketplace
- Collection offer - offer on a collection
- Item transferred - transfer of an item between wallets
- Item metadata updated - update detected on the metadata provided in token name, imgUrl for an item
- Pending transfer - item is in transferring
The Stream API is available for both Mainnet and Testnet networks:
Ethereum, Polygon mainnet, Bsc mainnet, Avalanche mainnet
Goerli, Polygon testnet (Mumbai), Bsc testnet, Avalanche testnet
- collection:* subscribe all collections.
- Such as: "events":["item_sold"]
-  means to subscribe to all events
- payload.chains: filter chains,
- When subscribing to all collections, chain information is required
- Currently supported values ethereum, polygon, bsc, avalanche
- When the collection slug is specified, the chain information is invalid
- payload.markets: filter markets,
- Currently supported values element, opensea, looksrare
- Subscription is based on topic, sending subscription information of the same topic will overwrite the previous subscription
If you want to use the API in Mainnet, an API key is required. If you don’t have an API key, Please submit a request here.
No, events are not counted towards any API rate limits.
The streaming rate depends on a range of factors - from the amount of collections that you’re monitoring to the type and amount of events that you’re subscribed to. For instance, if you’re subscribed to receive bid events across all collections on Element, you’ll be receiving messages at a significantly higher rate than you will for a subscription to order cancellations on a small collection.
You should be prepared to handle receipt of events out of order as we don’t guarantee delivery of events in the order that they occur.
The Stream API is a best-effort delivery messaging system and messages that are not received due to connection errors will not be re-sent. So it’s possible that there can be missing messages if the socket connection is unstable.
The following blockchains are supported on Mainnet networks:
The following blockchains are supported on Testnet networks:
Polygon testnet (Mumbai)
The following market are supported on Mainnet networks: