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
  • Solana: Magic Eden
  • Polygon: OpenSea (Seaport contract)
  • Arbitrum: OpenSea, Stratos, Trove
  • Optimism: OpenSea, Quix
  • Avalanche: OpenSea
  • BSC: OpenSea

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 sold. Will be null if is_bundle_sale is trueint / null
timestampDatetime of the NFT salestring
transactionUnique identifier of the NFT sale transactionstring
marketplace_idID of the marketplace the sale occurred on (e.g. opensea)string
marketplace_nameName of the marketplace the sale occurred 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 / null
unit_priceIndividual unit price of an item within the NFT sale. Will be null if is_bundle_sale is trueint / null
total_priceTotal price of the NFT sale. Will be null if is_bundle_sale is trueint / null

sale_details model (included inline with the transfer model):

FieldDescriptionType(s)
marketplace_idID of the marketplace the sale occurred on (e.g. opensea)string / null
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 / null
unit_priceIndividual unit price of an item within the NFT sale. Will be null if is_bundle_sale is trueint / null
total_priceTotal price of the NFT sale. Will be null if is_bundle_sale is trueint / null

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 / null
symbolSymbol of the token derived from the contract or otherwise, e.g., ETHstring / null
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