The SimpleHash API includes detail on the sale of NFTs inline within the response bodies of both the NFT and transfer models. Currently NFT sale information will be returned for sales that occured on the marketplaces and chains shown here:

  • Ethereum: OpenSea, LooksRare
  • Polygon: OpenSea (Seaport contract)
  • Arbitrum: OpenSea, Stratos, Trove
  • Optimism: OpenSea, Quix

Coverage of more chains and marketplaces will be added in the near future.

On NFT responses, sale information is included in the field named last_sale, whereas in transfer responses, it is included in the field named sale_details


last_sale model (included inline with the NFT model):

FieldDescriptionType(s)
from_addressAddress selling the NFTstring, null
to_addressAddress acquiring the NFTstring, null
quantityThe quantity of NFTs being soldint
timestampDatetime of the NFT salestring
transactionUnique identifier of the NFT sale transactionstring
marketplace_nameName of the marketplace the sale occured on (e.g., OpenSea)string
is_bundle_saleWhether the sale was a bundle sale or not (a bundle sale is where several items are put up for sale on a marketplace at a single price)boolean
payment_tokenDetail on the token used to make the NFT sale. Will be null if is_bundle_sale is truepayment_token (see below), null
unit_priceIndividual unit price of an item within the NFT saleint
total_priceTotal price of the NFT saleint

sale_details model (included inline with the transfer model):

FieldDescriptionType(s)
marketplace_nameName of the marketplace the sale occured on (e.g., OpenSea)string
is_bundle_saleWhether the sale was a bundle sale or not (a bundle sale is where several items are put up for sale on a marketplace at a single price)boolean
payment_tokenDetail on the token used to make the NFT sale. Will be null if is_bundle_sale is truesee below table for payment_token model, null
unit_priceIndividual unit price of an item within the NFT saleint
total_priceTotal price of the NFT saleint

payment_token model:

FieldDescriptionType(s)
payment_token_idUnique identifier of the token type used to make the sale. Currently for ethereum ecosystem sales, this may be ethereum.native for the native ETH token, or ethereum.{contract_address} for ERC-20 tokensstring
nameName of the token, e.g., Ether derived from the contract or otherwisestring
symbolSymbol of the token derived from the contract or otherwise, e.g., ETHstring
addressContract address of the ERC-20 token used to make the sale (null in the case of the native ETH token)string,null
decimalsBase number of decimals of the token value involved in the NFT sale (e.g., 18 in the case of the native ETH token)int