Today, OpenSea has launched 2 new events in the Stream API. The new events will be emitted when orders, both listings and offers, have been invalidate or revalidated. Emitting these events will allow marketplace aggregators and other consumers who are maintaining a copy of the OpenSea order book to more easily ensure the orders are executable.

Orders can be invalidated for a large number of reasons included but not limited to revoking operator access for Seaport or WETH balance falling below the offer amount. When one of these cases are detected, OpenSea removes the order from the site and now emits an Invalidation Event. When one of these cases reverses for an unexpired order, for example a user refilling the WETH balance, the order can become active again and a Revalidation Event is emitted.

The new event types have been added to the Stream SDK in version 0.1.0.

For more information on the Stream API: https://docs.opensea.io/reference/stream-api-overview

Example Payloads

{
  chain: { name: 'ethereum' },
  collection: { slug: 'pudgypenguins' },
  event_timestamp: '2023-06-02T19:47:50.950428+00:00',
  item: {},
  order_hash: '0xeb3f34e967bc969932d1c4b55c49d7160dc3fa2c899745f42dbe383b98f60ec0',
  protocol_address: '0x00000000000000adc04c56bf30ac9d3c0aaf14dc'
}

{
  chain: { name: 'ethereum' },
  collection: { slug: 'pudgypenguins' },
  event_timestamp: '2023-06-02T19:47:50.950428+00:00',
  item: {},
  order_hash: '0xeb3f34e967bc969932d1c4b55c49d7160dc3fa2c899745f42dbe383b98f60ec0',
  protocol_address: '0x00000000000000adc04c56bf30ac9d3c0aaf14dc'
}