Transfer model

The SimpleHash API returns transfer data in a standard format. The following are the fields included in the response (or as a list of transfer objects). Transfers typically reflect the exchange of an NFT from one address to another.

nft_idUnique identifier for an NFT (chain.contract_address.token_id for EVM chains & Flow, chain.mint_address for Solana, chain.inscription_id for Bitcoin)string
chainName of the blockchain (e.g., ethereum)string
contract_addressContract address of the NFT involved. Hex format for EVM-compatible chains. This is the mint address for Solana and Inscription ID for Bitcoin.string
token_idToken ID (usually numeric) of the NFT on its contract. This will be null for Solana and Bitcoin NFTsstring / null
collection_idThe unique identifier of the collection (obtainable from an NFT response, or from the Collection endpoints)string/ null
event_typeThe type of transfer, one of: mint, sale, transfer, burnstring
from_addressOriginating address for the transfer. Hex format for EVM-compatible chains. If null, this represents a minting eventstring / null
to_addressDestination address for the transfer. Hex format for EVM-compatible chains. If null, this represents a burn eventstring / null
quantityQuantity of this NFT being transferred (can be greater than 1 for ERC-1155s)int
quantity_stringSame result as quantity as a stringstring
timestampBlock time of the event in timestamp format (e.g., 2021-07-03T23:45:00Z)string
block_numberNumeric figure representing the block number within which the transfer occurredint
block_hashDigital fingerprint / hash of the specific block. This will be null for Solana NFTsstring / null
transactionUnique identifier of the relevant transactionstring
transaction_initiatorWallet address that submitted the blockchain transaction, regardless of whether they are in the to_address or from_address field. This will be null for Solana, Flow, and Bitcoin NFTs.string / null
log_indexIndex of the log in the transaction event logsint
batch_transfer_indexIndex of the transfer in the log (Usually there is one transfer per log, but ERC-1155 allows for batch transfers in one log)int
sale_detailsDetails on the sale event that occurred in this transfer, if applicablesale_details / null