Parse Transaction(s)

Parse individual Solana transactions.

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. Please see Supported Protocols to see parsing coverage.

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

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

feePayerstring

signaturestring

slotinteger

timestampinteger

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

JavaScriptCurl

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

Response

[
  {
    "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();