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 . 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:

First, call to retrieve a batch of transaction signatures.
Next, use the endpoint with the received signatures.
If any transactions are missing from the response. You can retry fetching these 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();

PreviousParse Transaction(s)NextFAQs

Last updated 3 months ago

Was this helpful?

Parsed Transaction History

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:

First, call to retrieve a batch of transaction signatures.
Next, use the endpoint with the received signatures.
If any transactions are missing from the response. You can retry fetching these 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();

[ { "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 } } } ]

Responses

200

Returns an array of enriched transactions.

application/json

400

Invalid request.

401

Unauthorized request.

403

Request was forbidden.

404

The specified resource was not found.

429

Exceeded rate limit.

500

The server encountered an unexpected condition that prevented it from fulfilling the request.

Endpoints

Parsed Transaction History

Code Examples

Endpoints

Parsed Transaction History

Code Examples

v0/addresses/:address/transactions