NFT transactions retriever

[apis/nftport/v0/NFT transactions retriever]

icon

---

Returns all on-chain transactions for the specified NFT token, using the NFTPort API. Can be set to include transactions such as transfer, burn, mint, and sale, or all which includes all transactions. Supports Ethereum only. Retrieve transactions by NFT: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-nft

---

Keywords: web3, blockchain, crypto, nft, transaction, list, ethereum

Input ports

• query:

  {
    "contract_address": string,
    "token_id": string,
    optional "continuation": string,
    optional "page_size": number,
    optional "type": ("transfer" or "mint" or "burn" or "sale" or "all")[]
  }

  Receives search query. Rerefence: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-nft#Request Default type value: "all"

• params: {"api_key": string, optional "chain": "ethereum"}

  Rerefence: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-nft#Request Default chain value: "ethereum"

Output ports

• data:

  {
    "response": "OK",
    "transactions": (
      {
        "type": ("transfer" or "mint" or "burn"),
        optional "owner_address": string,
        optional "transfer_from": string,
        optional "transfer_to": string,
        "contract_address": string,
        "token_id": number,
        "quantity": 1,
        "transaction_hash": string,
        "block_hash": string,
        "block_number": number,
        "transaction_date": string
      }
      or {
        "type": "sale",
        optional "buyer_address": string,
        "seller_address": string,
        "nft": {
          "contract_type": ("ERC721" or "ERC1155"),
          "contract_address": string,
          "token_id": string,
          optional "metadata_url": (string or null),
          optional "creators": {"account_address": string, "creator_share": number}[],
          optional "royalties": {"account_address": string, "royalty_share": number}[],
          optional "signatures": string[],
          optional "total": number
        },
        "quantity": number,
        "price_details": {
          "asset_type": string,
          optional "contract_address": string,
          "price": number,
          "price_usd": number
        },
        "transaction_hash": string,
        "block_hash": string,
        "block_number": number,
        "transaction_date": string,
        "marketplace": ("opensea" or "rarible")
      }
      or {
        "type": ("bid" or "cancel_bid"),
        "bidder_address": string,
        "nft": {
          "contract_type": ("ERC721" or "ERC1155"),
          "contract_address": string,
          "token_id": string,
          optional "metadata_url": (string or null),
          optional "creators": {"account_address": string, "creator_share": number}[],
          optional "royalties": {"account_address": string, "royalty_share": number}[],
          optional "signatures": string[],
          optional "total": number
        },
        optional "quantity": number,
        "price_details": {
          "asset_type": string,
          optional "contract_address": string,
          "price": number,
          "price_usd": number
        },
        optional "transaction_hash": string,
        optional "block_hash": string,
        optional "block_number": number,
        "transaction_date": string,
        optional "marketplace": ("opensea" or "rarible")
      }
      or {
        "type": ("list" or "cancel_list"),
        "lister_address": string,
        "nft": {
          "contract_type": ("ERC721" or "ERC1155"),
          "contract_address": string,
          "token_id": string,
          optional "metadata_url": (string or null),
          optional "creators": {"account_address": string, "creator_share": number}[],
          optional "royalties": {"account_address": string, "royalty_share": number}[],
          optional "signatures": string[],
          optional "total": number
        },
        optional "quantity": number,
        "price_details": {
          "asset_type": string,
          optional "contract_address": string,
          "price": number,
          "price_usd": number
        },
        optional "transaction_hash": string,
        optional "block_hash": string,
        optional "block_number": number,
        "transaction_date": string,
        optional "marketplace": ("opensea" or "rarible")
      }
    )[],
    "continuation": string
  }

  https://docs.nftport.xyz/docs/nftport/?search=multi-chain-nft-search#Responses

• response:

  {"status": number, "headers": {string: any}, "body": string}

  Sends the original response. Reference: https://docs.nftport.xyz/docs/nftport/?search=multi-chain-nft-search#Responses

• error: {"error": string, "details": any}

  Sends the error, if any