Overview

This node interacts with the OpenSea API to list marketplace events such as sales, listings, offers, redemptions, and transfers related to NFTs. It is useful for users who want to monitor or analyze NFT market activities, filter events by type, collection, or account address, and paginate through results. For example, a user can retrieve the latest sales events for a specific NFT collection or track offers made on NFTs owned by a particular account.

Use Case Examples

1. Retrieve the latest 50 sales events for the 'boredapeyachtclub' collection ordered by sale date descending.
2. List all listing and offer events related to a specific account address with pagination support.

Properties

Output

JSON

• resource - The resource type, here always 'events'.
• operation - The operation performed, here 'listEvents'.
• timestamp - The ISO timestamp when the data was retrieved.
• data - The raw event data returned from the OpenSea API.
• summary
  • total_events - Total number of events returned in the response.
  • event_types - Unique event types included in the returned events.
  • collections - Unique collection slugs associated with the returned events.

Dependencies

• OpenSea API

Troubleshooting

• Common issues include invalid or missing API keys which may cause authentication errors. Ensure the API key credential is correctly configured if used.
• Pagination parameters like 'Next Cursor' must be correctly managed to avoid missing or duplicate data when paginating through results.
• Filtering parameters must be valid and correctly formatted; invalid filters may result in empty or error responses.

Links

• OpenSea API Documentation - Official documentation for the OpenSea API which this node uses to fetch event data.