NFT APINft API V2methods Older Version

getNFTSales

Gets NFT sales that have happened through on-chain marketplaces

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 a 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

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.