honestnft_utils.opensea

honestnft_utils.opensea.get_opensea_events(contract_address, account_address=None, continuous=True, cursor=None, event_type=None, have=[], limit=300, occurred_before=None, only_opensea=False, token_id=None)

API wrapper for the OpenSea events API. https://docs.opensea.io/reference/retrieving-asset-events

Parameters
  • contract_address (str) – The NFT contract address for the assets for which to show events.

  • account_address (Optional[str]) – A user account’s wallet address to filter for events on an account.

  • continuous (bool) – Return only first page of events or try to fetch all pages.

  • cursor (Optional[str]) – A cursor pointing to the page to retrieve.

  • event_type (Optional[str]) – The event type to filter. Can be “created” for new auctions, “successful” for sales, “cancelled”, “bid_entered”, “bid_withdrawn”, “transfer”, or “approve”.

  • have (list) – List of already fetched events. Used internally to paginate trough events.

  • limit (int) – Maximum number of events to fetch per request.

  • occurred_before (Optional[str]) – Only show events listed before this timestamp. Seconds since the Unix epoch.

  • only_opensea (bool) – Restrict to events on OpenSea auctions.

  • token_id (Optional[int]) – The token’s id to optionally filter by.

Return type

List[Dict[str, Any]]

Returns

A list of events.

honestnft_utils.opensea.is_collection_delisted(contract_address)

Check if a collection is delisted on OpenSea.

Parameters

contract_address (str) – The NFT contract address

Return type

bool

Returns

A boolean indicating if the collection is delisted or not.