🎨 NFT APINft Sales Endpoints

NFT Sales

Retrieves NFT sales that have occurred through on-chain marketplaces.

Please note that this endpoint is only available on Ethereum (Seaport, Wyvern, X2Y2, Blur, LooksRare, Cryptopunks), Polygon (Seaport) & Optimism (Seaport) mainnets.

Path parameters

apiKeystringRequired

Query parameters

fromBlockstringOptionalDefaults to 0

String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and “latest”. Defaults to “0”.

toBlockstringOptionalDefaults to latest

String - The block number to start fetching NFT sales data from. Allowed values are decimal and hex integers, and “latest”. Defaults to “latest”.

orderenumOptional

Enum - Whether to return the results ascending from startBlock or descending from startBlock. Defaults to descending (false).

Allowed values:
marketplaceenumOptional

Enum - The name of the NFT marketplace to filter sales by. The endpoint currently supports “seaport”, “wyvern”, “looksrare”, “x2y2”, “blur”, and “cryptopunks”. Defaults to returning sales from all supported marketplaces.

Allowed values:
contractAddressstringOptionalDefaults to 0xe785E82358879F061BC3dcAC6f0444462D4b5330

String - The contract address of an NFT collection to filter sales by. Defaults to returning all NFT contracts.

tokenIdstringOptionalDefaults to 44

String - The token ID of an NFT within the collection specified by contractAddress to filter sales by. Defaults to returning all token IDs.

buyerAddressstringOptional

String - The address of the NFT buyer to filter sales by. Defaults to returning sales involving any buyer.

sellerAddressstringOptional

String - The address of the NFT seller to filter sales by. Defaults to returning sales involving any seller.

takerenumOptional

Enum - Filter by whether the buyer or seller was the taker in the NFT trade. Allowed filter values are “BUYER” and “SELLER”. Defaults to returning both buyer and seller taker trades.

Allowed values:
limitintegerOptional

Integer - The maximum number of NFT sales to return. Maximum and default values are 1000.

pageKeystringOptional

String - key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results.

Response

Returns a list of NFT sales that match the query parameters.

nftSaleslist of objectsOptional

List of NFT sales that match the query.

pageKeystringOptional

String - The page key to use to fetch the next page of results. Returns null if there are no more results.

validAtobjectOptional

Block Information of the block as of which the corresponding data is valid