Get NFT Collection Events

Returns transactions for an NFT collection across any marketplace.

Endpoint: getNftEvents

Method: POST

Arguments

NameTypeDescription
addressString

The contract address of the NFT collection.

cursorString

The cursor to use for pagination.

exchangeAddressString

The NFT marketplace address to filter by.

includeTransfersBoolean

limitInt

The maximum number of NFT events to return.

networkIdInt!

The network ID the NFT collection is deployed on.

Required
poolAddressString

The NFT pool address to filter by.

timestampEventQueryTimestampInput

The time range to filter by.

tokenIdString

The token ID to filter by.

NameTypeDescription
fromInt!

The unix timestamp for the start of the requested range.

Required
toInt!

The unix timestamp for the end of the requested range.

Required

Response

NameTypeDescription
cursorStringA cursor for use in pagination.
items[NftEvent]A list of transactions for an NFT collection.

NameTypeDescription
aggregatorAddressStringThe contract address of the marketplace aggregator that routed the transaction.
blockNumberInt!The block number for the transaction.
contractAddressString!The contract address of the NFT collection.
eventTypeString!The event type of the transaction.
exchangeAddressString!The NFT marketplace address of the transaction.
fillSourceStringThe name of the marketplace that processed the transaction.
idString!The ID of the NFT event (contractAddress:tokenId:networkId).
individualPriceNetworkBaseTokenStringThe price of each individual NFT in the network's base token.
individualPriceUsdStringThe price of each individual NFT in USD.
individualTradePriceStringThe price of each individual NFT in the purchasing token.
logIndexInt!The index of the log in the block.
makerString!The wallet address of the buyer.
networkIdInt!The network ID the NFT collection is deployed on.
numberOfTokensStringThe number of assets involved in the transaction.
orderDirectionNftEventOrderDirectionThe direction of the order. One of 'BUY', 'SELL', or 'OFFER_ACCEPTED'.
paymentTokenAddressString!The contract address of the purchasing token.
poolAddressStringThe contract address of the NFT pool, if applicable.
priceErrorStringThe reason for the price error, if applicable. Can be NO_TOKEN_DATA, NO_TOKEN_PRICE, or LOW_LIQUIDITY_PAIR.
sortKeyString!The sortKey for the event (blockNumber#transactionIndex#logIndex (+ #marketplaceEventLogIndex if applicable), zero padded). For example, 0000000016414564#00000224#00000413#00000414.
takerString!The wallet address of the seller.
timestampInt!The unix timestamp for the transaction.
tokenIdString!The token ID of the NFT asset involved in the transaction.
totalPriceNetworkBaseTokenStringThe total trade price for the transaction in the network's base token. (The transaction can include more than 1 token).
totalPriceUsdStringThe total trade price for the transaction in USD. (The transaction can include more than 1 token).
totalTradePriceStringThe total trade price for the transaction in the purchasing token. (The transaction can include more than 1 token).
tradeOffer[NftEventTradeItem!]The tokens/NFTs that were offered to make this transaction occur.
tradeReceived[NftEventTradeItem!]The tokens/NFTs that were received in this transaction.
transactionHashString!The unique hash for the transaction.
transactionIndexInt!The index of the transaction within the block.

Explore

πŸ‘‹

Join our Discord

Ask questions, share what you're working on and request new features :two-men-holding-hands::two-women-holding-hands: