Returns transactions for an NFT collection across any marketplace.
Endpoint: getNftEvents
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| address | String | The contract address of the NFT collection. |
| cursor | String | The cursor to use for pagination. |
| exchangeAddress | String | The NFT marketplace address to filter by. |
| includeTransfers | Boolean | |
| limit | Int | The maximum number of NFT events to return. |
| networkId | Int! | The network ID the NFT collection is deployed on. Required |
| poolAddress | String | The NFT pool address to filter by. |
| timestamp | EventQueryTimestampInput | The time range to filter by. |
| tokenId | String | The token ID to filter by. |
Response
| Name | Type | Description |
|---|---|---|
| aggregatorAddress | String | The contract address of the marketplace aggregator that routed the transaction. |
| blockNumber | Int! | The block number for the transaction. |
| contractAddress | String! | The contract address of the NFT collection. |
| eventType | String! | The event type of the transaction. |
| exchangeAddress | String! | The NFT marketplace address of the transaction. |
| fillSource | String | The name of the marketplace that processed the transaction. |
| id | String! | The ID of the NFT event (contractAddress:tokenId:networkId). |
| individualPriceNetworkBaseToken | String | The price of each individual NFT in the network's base token. |
| individualPriceUsd | String | The price of each individual NFT in USD. |
| individualTradePrice | String | The price of each individual NFT in the purchasing token. |
| logIndex | Int! | The index of the log in the block. |
| maker | String! | The wallet address of the buyer. |
| networkId | Int! | The network ID the NFT collection is deployed on. |
| numberOfTokens | String | The number of assets involved in the transaction. |
| orderDirection | NftEventOrderDirection | The direction of the order. One of 'BUY', 'SELL', or 'OFFER_ACCEPTED'. |
| paymentTokenAddress | String! | The contract address of the purchasing token. |
| poolAddress | String | The contract address of the NFT pool, if applicable. |
| priceError | String | The reason for the price error, if applicable. Can be NO_TOKEN_DATA, NO_TOKEN_PRICE, or LOW_LIQUIDITY_PAIR. |
| sortKey | String! | The sortKey for the event (blockNumber#transactionIndex#logIndex (+ #marketplaceEventLogIndex if applicable), zero padded). For example, 0000000016414564#00000224#00000413#00000414. |
| taker | String! | The wallet address of the seller. |
| timestamp | Int! | The unix timestamp for the transaction. |
| tokenId | String! | The token ID of the NFT asset involved in the transaction. |
| totalPriceNetworkBaseToken | String | The total trade price for the transaction in the network's base token. (The transaction can include more than 1 token). |
| totalPriceUsd | String | The total trade price for the transaction in USD. (The transaction can include more than 1 token). |
| totalTradePrice | String | The 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. |
| transactionHash | String! | The unique hash for the transaction. |
| transactionIndex | Int! | The index of the transaction within the block. |
Explore
Ask questions, share what you're working on and request new features 👬👭