Skip to content

events.md

Latest commit

 

History

History
41 lines (31 loc) · 1.09 KB

events.md

File metadata and controls

41 lines (31 loc) · 1.09 KB

Event Types

The events commands accept an --event-type flag to filter by event type.

Valid event types

Type Description
sale NFT sold
transfer NFT transferred between wallets
mint NFT minted
listing NFT listed for sale
offer Offer made on an NFT
trait_offer Offer made on NFTs with a specific trait
collection_offer Offer made on any NFT in a collection

CLI usage

# Filter by event type
opensea events list --event-type sale --limit 5

# Combine with other filters
opensea events by-collection mfers --event-type transfer --limit 10
opensea events by-account 0x123... --event-type mint --chain ethereum
opensea events by-nft ethereum 0x123... 1 --event-type listing

# Time-based filtering (events list only)
opensea events list --event-type sale --after 1700000000 --before 1700100000

SDK usage

const { asset_events } = await client.events.byCollection("mfers", {
  eventType: "sale",
  limit: 10,
})

Note: The CLI uses --event-type (kebab-case) while the SDK uses eventType (camelCase).