Parse Transaction(s)

Parse individual Solana transactions.

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

The max number of transactions you can pass in to this endpoint is 100. We only parse NFT actions, Jupiter swaps, and SPL related transactions so far. Do not rely on these parsers for DeFi or non-NFT, Jupiter, and SPL transactions.

v0/transactions

Returns an array of enriched, human-readable transactions of the given transaction signatures. For a full list of Transaction Types and Sources, please see Transaction Types.

Mainnet URL: https://api.helius.xyz/v0/transactions Devnet URL: https://api-devnet.helius.xyz/v0/transactions

Returns an array of enriched, human-readable versions of the given transactions.

POSThttps://api.helius.xyz/v0/transactions

Query parameters

Body

application/json

transactionsarray of string

Response

200400401403404429500

Returns an array of enriched transactions.

Body

application/json

descriptionstring

Example: "Human readable interpretation of the transaction"

typeTransactionType (enum)

UNKNOWNNFT_BIDNFT_BID_CANCELLEDNFT_LISTINGNFT_CANCEL_LISTINGNFT_SALENFT_MINTNFT_AUCTION_CREATEDNFT_AUCTION_UPDATEDNFT_AUCTION_CANCELLEDNFT_PARTICIPATION_REWARDNFT_MINT_REJECTEDCREATE_STOREWHITELIST_CREATORADD_TO_WHITELISTREMOVE_FROM_WHITELISTAUCTION_MANAGER_CLAIM_BIDEMPTY_PAYMENT_ACCOUNTUPDATE_PRIMARY_SALE_METADATAADD_TOKEN_TO_VAULTACTIVATE_VAULTINIT_VAULTINIT_BANKINIT_STAKEMERGE_STAKESPLIT_STAKESET_BANK_FLAGSSET_VAULT_LOCKUPDATE_VAULT_OWNERUPDATE_BANK_MANAGERRECORD_RARITY_POINTSADD_RARITIES_TO_BANKINIT_FARMINIT_FARMERREFRESH_FARMERUPDATE_FARMAUTHORIZE_FUNDERDEAUTHORIZE_FUNDERFUND_REWARDCANCEL_REWARDLOCK_REWARDPAYOUTVALIDATE_SAFETY_DEPOSIT_BOX_V2SET_AUTHORITYINIT_AUCTION_MANAGER_V2UPDATE_EXTERNAL_PRICE_ACCOUNTAUCTION_HOUSE_CREATECLOSE_ESCROW_ACCOUNTWITHDRAWDEPOSITTRANSFERBURNBURN_NFTPLATFORM_FEELOANRESCIND_LOANOFFER_LOANREPAY_LOANTAKE_LOANFORECLOSE_LOANADD_TO_POOLREMOVE_FROM_POOLCLOSE_POSITIONUNLABELEDCLOSE_ACCOUNTWITHDRAW_GEMDEPOSIT_GEMSTAKE_TOKENUNSTAKE_TOKENSTAKE_SOLUNSTAKE_SOLCLAIM_REWARDSBUY_SUBSCRIPTIONSWAPINIT_SWAPCANCEL_SWAPREJECT_SWAPINITIALIZE_ACCOUNTTOKEN_MINTCREATE_APPARAISALFUSEDEPOSIT_FRACTIONAL_POOLFRACTIONALIZECREATE_RAFFLEBUY_TICKETSUPDATE_ITEMLIST_ITEMDELIST_ITEMADD_ITEMCLOSE_ITEMBUY_ITEMFILL_ORDERUPDATE_ORDERCREATE_ORDERCLOSE_ORDERCANCEL_ORDERKICK_ITEMUPGRADE_FOXUPGRADE_FOX_REQUESTLOAN_FOXBORROW_FOXSWITCH_FOX_REQUESTSWITCH_FOXCREATE_ESCROWACCEPT_REQUEST_ARTISTCANCEL_ESCROWACCEPT_ESCROW_ARTISTACCEPT_ESCROW_USERPLACE_BETPLACE_SOL_BETCREATE_BETNFT_RENT_UPDATE_LISTINGNFT_RENT_ACTIVATENFT_RENT_CANCEL_LISTINGNFT_RENT_LISTINGFINALIZE_PROGRAM_INSTRUCTIONUPGRADE_PROGRAM_INSTRUCTIONNFT_GLOBAL_BIDNFT_GLOBAL_BID_CANCELLEDEXECUTE_TRANSACTIONAPPROVE_TRANSACTIONACTIVATE_TRANSACTIONCREATE_TRANSACTIONREJECT_TRANSACTIONCANCEL_TRANSACTIONADD_INSTRUCTION

sourceTransactionSource (enum)

FORM_FUNCTIONEXCHANGE_ARTCANDY_MACHINE_V2CANDY_MACHINE_V1UNKNOWNSOLANARTSOLSEAMAGIC_EDENHOLAPLEXMETAPLEXOPENSEASOLANA_PROGRAM_LIBRARYANCHORW_SOLPHANTOMSYSTEM_PROGRAMSTAKE_PROGRAMCOINBASECORAL_CUBEHEDGELAUNCH_MY_NFTGEM_BANKGEM_FARMDEGODSBLOCKSMITH_LABSYAWWWATADIASOLPORTHYPERSPACEDIGITAL_EYESELIXIRELIXIR_LAUNCHPADTENSORBIFROSTJUPITERMERCURIAL_STABLE_SWAPSABERSERUMSTEP_FINANCECROPPERRAYDIUMALDRINCREMALIFINITYCYKURAORCAMARINADESTEPNSENCHA EXCHANGESAROSENGLISH_AUCTION_AUCTIONFOXYFOXY_STAKINGFOXY_RAFFLEFOXY_TOKEN_MARKETFOXY_COINFLIPZETAHADESWAPCARDINAL_RENTCARDINAL_STAKINGBPF_UPGRADEABLE_LOADERBPF_LOADERSQUADSOPEN_CREATOR_PROTOCOL

feeinteger

Example: 5000

feePayerstring

Example: "8cRrU1NzNpjL3k2BwjW3VixAcX6VFc29KHr4KZg8cs2Y"

signaturestring

Example: "yy5BT9benHhx8fGCvhcAfTtLEHAtRJ3hRTzVL16bdrTCWm63t2vapfrZQZLJC3RcuagekaXjSs2zUGQvbcto8DK"

slotinteger

Example: 148277128

timestampinteger

Example: 1656442333

nativeTransfersarray of NativeTransfer (object)

tokenTransfersarray of TokenTransfer (object)

accountDataarray of AccountData (object)

transactionErrorinline_response_400 (object)

instructionsarray of Instruction (object)

eventsEnrichedTransaction_events (object)

Events associated with this transaction. These provide fine-grained information about the transaction. They match the types returned from the event APIs.

Request

JavaScriptCurlPython

const response = await fetch('https://api.helius.xyz/v0/transactions?api-key=text', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403404429500

[
  {
    "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"
      }
    ],
    "tokenTransfers": [
      {
        "fromUserAccount": "text",
        "toUserAccount": "text",
        "fromTokenAccount": "text",
        "toTokenAccount": "text",
        "tokenAmount": 0,
        "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
      }
    ],
    "accountData": [
      {
        "account": "text",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text"
            }
          }
        ]
      }
    ],
    "transactionError": {
      "error": "text"
    },
    "instructions": [
      {
        "accounts": [
          "8uX6yiUuH4UjUb1gMGJAdkXorSuKshqsFGDCFShcK88B"
        ],
        "data": "kdL8HQJrbbvQRGXmoadaja1Qvs",
        "programId": "MEisE1HzehtrDpAAT8PnLHjpSSkRYakotTuJRPjTpo8",
        "innerInstructions": [
          {
            "accounts": [
              "text"
            ],
            "data": "text",
            "programId": "text"
          }
        ]
      }
    ],
    "events": {
      "nft": {
        "description": "text",
        "type": "NFT_SALE",
        "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"
            }
          }
        ],
        "tokenOutputs": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text"
            }
          }
        ],
        "tokenFees": [
          {
            "userAccount": "F54ZGuxyb2gA7vRjzWKLWEMQqCfJxDY1whtqtjdq4CJ",
            "tokenAccount": "2kvmbRybhrcptDnwyNv6oiFGFEnRVv7MvVyqsxkirgdn",
            "mint": "DUSTawucrTsGU8hcqRdHDCbuYhCPADMLM2VcCb8VnFnQ",
            "rawTokenAmount": {
              "tokenAmount": "text"
            }
          }
        ],
        "nativeFees": [
          {
            "account": "2uySTNgvGT2kwqpfgLiSgeBLR3wQyye1i1A2iQWoPiFr",
            "amount": "100000000"
          }
        ],
        "innerSwaps": [
          {
            "tokenInputs": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 0,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "tokenOutputs": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 0,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "tokenFees": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text",
                "fromTokenAccount": "text",
                "toTokenAccount": "text",
                "tokenAmount": 0,
                "mint": "DsfCsbbPH77p6yeLS1i4ag9UA5gP9xWSvdCx72FJjLsx"
              }
            ],
            "nativeFees": [
              {
                "fromUserAccount": "text",
                "toUserAccount": "text"
              }
            ],
            "programInfo": {
              "source": "ORCA",
              "account": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
              "programName": "ORCA_WHIRLPOOLS",
              "instructionName": "whirlpoolSwap"
            }
          }
        ]
      }
    }
  }
]

Code Samples

parseTransaction.js

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

const parseTransaction = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      transactions: ["your-txn-id-here"],
    }),
  });

  const data = await response.json();
  console.log("parsed transaction: ", data);
};

parseTransaction();