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.
Field | Description | Type(s) |
---|---|---|
nft_id | Unique identifier for an NFT (chain.contract_address.token_id for EVM chains & Flow, chain.mint_address for Solana, chain.inscription_id for Bitcoin) | string |
chain | Name of the blockchain (e.g., ethereum) | string |
contract_address | Contract 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_id | Token ID (usually numeric) of the NFT on its contract. This will be null for Solana and Bitcoin NFTs | string / null |
collection_id | The unique identifier of the collection (obtainable from an NFT response, or from the Collection endpoints) | string / null |
event_type | The type of transfer, one of: mint , sale , transfer , burn | string |
from_address | Originating address for the transfer. Hex format for EVM-compatible chains. If null , this represents a minting event | string / null |
to_address | Destination address for the transfer. Hex format for EVM-compatible chains. If null , this represents a burn event | string / null |
quantity | Quantity of this NFT being transferred (can be greater than 1 for ERC-1155s) | int |
quantity_string | Same result as quantity as a string | string |
timestamp | Block time of the event in timestamp format (e.g., 2021-07-03T23:45:00Z) | string |
block_number | Numeric figure representing the block number within which the transfer occurred | int |
block_hash | Digital fingerprint / hash of the specific block. This will be null for Solana NFTs | string / null |
transaction | Unique identifier of the relevant transaction | string |
transaction_index | Position of the transaction within the block. The may be null for earlier records, but log_index can be used instead of ordering within a block. | int / null |
transaction_initiator | Wallet 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_index | Index of the log in the transaction event logs | int |
batch_transfer_index | Index 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_details | Details on the sale event that occurred in this transfer, if applicable | sale_details / null |
is_removed | [For transfer webhooks only] - Indicates whether a transfer is removed due to a reorg | bool/null |