Transpose · Schema

NFT Transfer

An NFT transfer event representing a mint, transfer, or burn of an ERC-721 or ERC-1155 token.

BlockchainNFTCryptocurrencyWeb3EthereumToken TransfersSmart ContractsHistorical DataDeFiDEX

Properties

Name	Type	Description
transaction_hash	string	Hash of the transaction containing this transfer.
log_index	integer	Index of the event log within the transaction.
block_number	integer	Block number containing this transfer.
timestamp	string	ISO-8601 timestamp of the block that included this transfer.
contract_address	string	Contract address of the NFT collection.
token_id	string	The NFT token ID (as string to support large integers).
from_address	string	Sender address. Zero address (0x000...000) indicates a mint.
to_address	string	Recipient address. Zero address indicates a burn.
token_standard	string	The token standard governing this transfer.
quantity	integernull	Number of tokens transferred. Always 1 for ERC-721; may be >1 for ERC-1155.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api.transpose.io/schemas/nft-transfer",
  "title": "NFT Transfer",
  "description": "An NFT transfer event representing a mint, transfer, or burn of an ERC-721 or ERC-1155 token.",
  "type": "object",
  "properties": {
    "transaction_hash": {
      "type": "string",
      "description": "Hash of the transaction containing this transfer.",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "log_index": {
      "type": "integer",
      "description": "Index of the event log within the transaction.",
      "minimum": 0
    },
    "block_number": {
      "type": "integer",
      "description": "Block number containing this transfer.",
      "minimum": 0
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO-8601 timestamp of the block that included this transfer."
    },
    "contract_address": {
      "type": "string",
      "description": "Contract address of the NFT collection.",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "token_id": {
      "type": "string",
      "description": "The NFT token ID (as string to support large integers)."
    },
    "from_address": {
      "type": "string",
      "description": "Sender address. Zero address (0x000...000) indicates a mint.",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "to_address": {
      "type": "string",
      "description": "Recipient address. Zero address indicates a burn.",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "token_standard": {
      "type": "string",
      "description": "The token standard governing this transfer.",
      "enum": ["erc721", "erc1155"]
    },
    "quantity": {
      "type": ["integer", "null"],
      "description": "Number of tokens transferred. Always 1 for ERC-721; may be >1 for ERC-1155.",
      "minimum": 1
    }
  },
  "required": [
    "transaction_hash",
    "block_number",
    "timestamp",
    "contract_address",
    "token_id",
    "from_address",
    "to_address",
    "token_standard"
  ],
  "additionalProperties": true
}