NFT transactions by account retriever

[apis/nftport/v0/NFT transactions by account retriever]


Returns all on-chain transactions as well as OpenSea and Rarible order book data for the specified account (i.e. wallet) address, using the NFTPort API. Can be set to include transactions such as mint, burn, transfer_from, transfer_to, list, buy, sell and OpenSea order book data such as make_bid and get_bid, or all which includes all transactions. Supports Ethereum only. Retrieve transactions by an account: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-an-account


Keywords: web3, blockchain, crypto, nft, transaction, owner, account, opensea, rarible, ethereum

Input ports

  • query:

    {
      "account_address": string,
      optional "continuation": string,
      optional "page_size": number,
      optional "type": (
        "transfer_from"
        or "transfer_to"
        or "mint"
        or "burn"
        or "make_bid"
        or "get_bid"
        or "list"
        or "buy"
        or "sell"
        or "all"
      )[]
    }

    Receives search query. Rerefence: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-an-account#Request

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

    Rerefence: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-an-account#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
    }

    Sends the query response. Reference: https://docs.nftport.xyz/docs/nftport/?search=retrieve-transactions-by-an-account#Responses

  • response:

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

    Sends the original response.

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

    Sends the error, if any

Last updated