Parsed Transaction History

Parsed Transaction History for any given address.

Enhanced Transaction API V1 won't be updated while we work on V2.

Endpoints

Replace {address} with the specific address for which you want to retrieve transaction data.

• Mainnet – https://api.helius.xyz/v0/addresses/{address}/transactions

• Devnet – https://api-devnet.helius.xyz/v0/addresses/{address}/transactions

Parsed Transaction History

Returns the enriched transaction history for a given address. For a full list of Transaction Types and Sources, please see Transaction Types. With no parameters set, this will return the latest transactions for an address.

We only parse NFT, Jupiter, and SPL related transactions. Do not rely on these parsers for DeFi or non-NFT, Jupiter, and SPL transactions.

Occasionally, this endpoint may return an incomplete set of transactions due to internal timeouts during data retrieval.

To mitigate this issue, we recommend to:

1. First, call getSignaturesForAddress to retrieve a batch of transaction signatures.

2. Next, use the /v0/transactions endpoint with the received signatures.

3. If any transactions are missing from the response. You can retry fetching these transactions.

v0/addresses/:address/transactions

get

Authorizations

Path parameters

addressstringrequired

The address to query for.

Query parameters

api-keystringrequired

The api key.

beforestringoptional

Start searching backwards from this transaction signature.

untilstringoptional

Search until this transaction signature.

commitmentstring · enumoptional

How finalized a block must be to be included in the search. If not provided, will default to "finalized" commitment. Note that "processed" level commitment is not supported.

Available options:

sourcestring · enumoptional

The TransactionSource to filter by. For a list of possible options, see the Transaction Types section.

Available options:

typestring · enumoptional

The TransactionType to filter by. For a list of possible options, see the Transaction Types section.

Available options:

limitinteger · min: 1 · max: 100optional

The number of transactions to retrieve. The value should be between 1 and 100.

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://api.helius.xyz/v0/addresses/{address}/transactions?api-key=text' \
  --header 'Authorization: Basic username:password'

200

400

401

403

404

429

500

200

[
  {
    "description": "Human readable interpretation of the transaction",
    "type": "UNKNOWN",
    "source": "FORM_FUNCTION",
    "fee": 5000,
    "feePayer": "8cRrU1NzNpjL3k2BwjW3VixAcX6VFc29KHr4KZg8cs2Y",
    "signature": "yy5BT9benHhx8fGCvhcAfTtLEHAtRJ3hRTzVL16bdrTCWm63t2vapfrZQZLJC3RcuagekaXjSs2zUGQvbcto8DK",
    "slot": 148277128,
    "timestamp": 1656442333,
    "nativeTransfers": [
      {
        "fromUserAccount": "text",
        "toUserAccount": "text",
        "amount": 1
      }
    ],
    "tokenTransfers": [
      {
        "fromUserAccount": "text",
        "toUserAccount": "text",
        "fromTokenAccount": "text",
        "toTokenAccount": "text",
        "tokenAmount": 1,
        "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
      }
    ],
    "accountData": [
      {
        "account": "text",
        "nativeBalanceChange": 1,
        "tokenBalanceChanges": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text",
              "decimals": 1
            }
          }
        ]
      }
    ],
    "transactionError": {
      "error": "text"
    },
    "instructions": [
      {
        "accounts": [
          "8uX6yiUuH4UjUb1gMGJAdkXorSuKshqsFGDCFShcK88B"
        ],
        "data": "kdL8HQJrbbvQRGXmoadaja1Qvs",
        "programId": "MEisE1HzehtrDpAAT8PnLHjpSSkRYakotTuJRPjTpo8",
        "innerInstructions": [
          {
            "accounts": [
              "text"
            ],
            "data": "text",
            "programId": "text"
          }
        ]
      }
    ],
    "events": {
      "nft": {
        "description": "text",
        "type": "NFT_BID",
        "source": "FORM_FUNCTION",
        "amount": 1000000,
        "fee": 5000,
        "feePayer": "8cRrU1NzNpjL3k2BwjW3VixAcX6VFc29KHr4KZg8cs2Y",
        "signature": "4jzQxVTaJ4Fe4Fct9y1aaT9hmVyEjpCqE2bL8JMnuLZbzHZwaL4kZZvNEZ6bEj6fGmiAdCPjmNQHCf8v994PAgDf",
        "slot": 148277128,
        "timestamp": 1656442333,
        "saleType": "AUCTION",
        "buyer": "text",
        "seller": "text",
        "staker": "text",
        "nfts": [
          {
            "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx",
            "tokenStandard": "NonFungible"
          }
        ]
      },
      "swap": {
        "nativeInput": {
          "account": "2uySTNgvGT2kwqpfgLiSgeBLR3wQyye1i1A2iQWoPiFr",
          "amount": "100000000"
        },
        "nativeOutput": {
          "account": "2uySTNgvGT2kwqpfgLiSgeBLR3wQyye1i1A2iQWoPiFr",
          "amount": "100000000"
        },
        "tokenInputs": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text",
              "decimals": 1
            }
          }
        ],
        "tokenOutputs": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text",
              "decimals": 1
            }
          }
        ],
        "tokenFees": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text",
              "decimals": 1
            }
          }
        ],
        "nativeFees": [
          {
            "account": "2uySTNgvGT2kwqpfgLiSgeBLR3wQyye1i1A2iQWoPiFr",
            "amount": "100000000"
          }
        ],
        "innerSwaps": [
          {
            "tokenInputs": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 1,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "tokenOutputs": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 1,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "tokenFees": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 1,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "nativeFees": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "amount": 1
              }
            ],
            "programInfo": {
              "source": "ORCA",
              "account": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
              "programName": "ORCA_WHIRLPOOLS",
              "instructionName": "whirlpoolSwap"
            }
          }
        ]
      },
      "compressed": {
        "type": "COMPRESSED_NFT_MINT",
        "treeId": "text",
        "assetId": "text",
        "leafIndex": 1,
        "instructionIndex": 1,
        "innerInstructionIndex": 1,
        "newLeafOwner": "text",
        "oldLeafOwner": "text"
      },
      "distributeCompressionRewards": {
        "amount": 1
      },
      "setAuthority": {
        "account": "text",
        "from": "text",
        "to": "text",
        "instructionIndex": 1,
        "innerInstructionIndex": 1
      }
    }
  }
]

Returns an array of enriched transactions.

Code Examples

Basic Example

parseTransactions.js

const url = "https://api.helius.xyz/v0/addresses/M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K/transactions?api-key=<your-key>";

const parseTransactions = async () => {
  const response = await fetch(url);
  const data = await response.json();
  console.log("parsed transactions: ", data);
};

parseTransactions();

Fetch all transactions using Pagination

let base_url = `https://api.helius.xyz/v0/addresses/2k5AXX4guW9XwRQ1AKCpAuUqgWDpQpwFfpVFh3hnm2Ha/transactions?api-key=<api-key>`;
let url = base_url;
let lastSignature = null;

const fetchAndParseTransactions = async () => {
  while (true) {
    if (lastSignature) {
      url = base_url + `&before=${lastSignature}`;
    }
    const response = await fetch(url);
    const transactions = await response.json();

    if (transactions && transactions.length > 0) {
      console.log("Fetched transactions: ", JSON.stringify(transactions));
      lastSignature = transactions[transactions.length - 1].signature;
    } else {
      console.log("No more transactions available.");
      break;
    }
  }
};
fetchAndParseTransactions();

Fetch NFT Sale Transaction

const tokenAddress = "GjUG1BATg5V4bdAr1csKys1XK9fmrbntgb1iV7rAkn94"
// NFT TRANSACTION SEARCH
const url = `https://api.helius.xyz/v0/addresses/${tokenAddress}/transactions?api-key=${apiKey}&type=NFT_SALE`

const parseNFT = async () => {
  const response = await fetch(url);
  const data = await response.json();
  console.log("nft transactions: ", data);
};

parseNFT();

Fetch Transactions of a Wallet

const walletAddress = "2k5AXX4guW9XwRQ1AKCpAuUqgWDpQpwFfpVFh3hnm2Ha"
// WALLET TRANSACTION SEARCH
const url = `https://api.helius.xyz/v0/addresses/${walletAddress}/transactions?api-key=${apiKey}`

const parseWallet = async () => {
  const response = await fetch(url);
  const data = await response.json();
  console.log("wallet transactions: ", data);
};

parseWallet();