Parsed Events – Schnellstart

Parsed Events ist neu für dich? Lies zuerst das mentale Modell von Parsed Streams. Parsed Events gibt dieselben decodierten Anweisungen über REST zurück.

Schnellstart

Get Access

Parsed Events ist in allen Tarifen für 10 Credits pro request verfügbar. Hole deinen API key im Helius Dashboard und sende requests an https://mainnet.helius-rpc.com.Authentifiziere dich mit dem API key deines Projekts. Übergib ihn als Query-Parameter api-key.

Parse a Transaction

Übergib Signaturen im Body-Feld transactions von POST /v1/parsed-events/transactions:

JavaScript
cURL

const parseTransactions = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      transactions: [
        "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      ],
      includeRawTransaction: false,
    }),
  });

  const data = await response.json();
  console.log(data);
};

parseTransactions();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "transactions": [
      "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
    ],
    "includeRawTransaction": false
  }'

Read the Result

Die response enthält für jede angeforderte Signatur ein Ergebnis in der Reihenfolge der Eingabe. Jedes Ergebnis enthält signature, parserStatus und entweder parsed oder parserError:

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "OK",
    "parsed": {
      "slot": 433950192,
      "blockTime": 1784487060,
      "fee": 2005000,
      "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "transactionStatus": "OK",
      "nativeTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "amount": 1500000000000
        }
      ],
      "tokenTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
          "fromTokenAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "toTokenAccount": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
          "rawTokenAmount": 1498500000000,
          "decimals": 9,
          "tokenStandard": "Fungible",
          "mint": "So11111111111111111111111111111111111111112"
        }
      ],
      "summary": {
        "type": "swap",
        "description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
        "parsedData": {
          "type": "swap",
          "protocol": "jupiter",
          "kind": "swap",
          "in_amount": "1500000000000",
          "actual_out_amount": "64672839261950",
          "input_mint": "So11111111111111111111111111111111111111112",
          "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
          "inner_swaps": [
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "470229300000",
              "output_amount": "35579021038",
              "input_mint": "So11111111111111111111111111111111111111112",
              "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "1028270700000",
              "output_amount": "77798063361",
              "input_mint": "So11111111111111111111111111111111111111112",
              "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "14625643887",
              "output_amount": "8348494812168",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "35566391375",
              "output_amount": "20283004384731",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "63185049137",
              "output_amount": "36041340065051",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            }
          ]
        }
      },
      "instructions": [
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 2,
          "stackHeight": 3,
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "rawAccounts": [
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE"
          ],
          "rawData": "3JvpRSxKFyKV",
          "summary": {
            "type": "transfer",
            "description": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE transferred 470.2293 SOL from 7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE to 8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "parsedData": null
          },
          "programName": "token",
          "instructionName": "transfer",
          "decoded": {
            "args": {
              "amount": "470229300000"
            },
            "accounts": [
              {
                "name": "source_account",
                "pubkey": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "destination_account",
                "pubkey": "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "owner_or_delegate",
                "pubkey": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
                "isSigner": true,
                "isWritable": false
              }
            ]
          }
        },
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 1,
          "stackHeight": 2,
          "programId": "BiSoNHVpsVZW2F7rx2eQ59yQwKxzU5NvBcmKshCSUypi",
          "rawAccounts": [
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
            "8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "EpdaePzdqRkMtdZJquVPUWgyoJ5YEEpYALki6dv9VBrt",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "Sysvar1nstructions1111111111111111111111111",
            "J1to1yufRnoWn81KYg1XkTWzmKjnYSnmE2VY8DGUJ9Qv"
          ],
          "rawData": "67t827t7UwAMHa6U18HnBBLj",
          "summary": null,
          "programName": "bison_fi",
          "instructionName": null,
          "decoded": null
        }
      ]
    }
  }
]

Das Beispiel ist auf zwei Instructions gekürzt: einen decodierten token-Transfer innerhalb der Route und eine AMM-Instruction, deren Programm der Katalog kennt, aber nicht decodieren kann. Daher bleibt instructionName auf null gesetzt, während rawData und rawAccounts weiterhin verfügbar sind. Unter Geparste response findest du alle Felder und ein vollständiges Beispiel für eine response.

Fetch Address History

POST /v1/parsed-events/transaction-history gibt für jede Transaktion, die eine Adresse berührt hat, dieselben geparsten Ergebnisse wie oben zurück. Standardmäßig erscheinen die neuesten zuerst:

JavaScript
cURL

const fetchTransactionHistory = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      address: "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      limit: 100,
      sortOrder: "desc",
      commitment: "confirmed",
    }),
  });

  const page = await response.json();
  console.log(page.data);
  console.log(page.paginationToken);
};

fetchTransactionHistory();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
      "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "limit": 100,
      "sortOrder": "desc",
      "commitment": "confirmed"
    }'

Paginate

Responses für den Verlauf geben die Ergebnisse in einem Seitenobjekt zurück. Übergib paginationToken im nächsten request erneut, um fortzufahren. Fehlt paginationToken, hat der Dienst das Ende des verfügbaren Seitenbereichs erreicht.

Anleitungen

Fetch Pump.fun Mints

Durchsuche seitenweise alle token, die eine Wallet auf Pump.fun bereitgestellt hat.

Migrate from Enhanced Transactions

Zuordnung von endpoint, Parametern und response aus der veralteten API.

REST-Referenz

Beide REST-Methoden akzeptieren über POST unter /v1/parsed-events/ an https://mainnet.helius-rpc.com einen JSON-Body. Die Authentifizierung erfolgt mit dem Abfrageparameter api-key. Der Body eines request lehnt unbekannte Felder ab. So führen Tippfehler direkt zu einem Fehler, statt stillschweigend ignoriert zu werden.

Transaktionen parsen

POST /v1/parsed-events/transactions ruft vollständige Solana-Transaktionen anhand ihrer Signatur ab, decodiert sie mit demselben IDL-basierten Anweisungsdecoder wie Parsed Streams und gibt für jede angeforderte Signatur ein TransactionResult zurück. Die Reihenfolge der response entspricht der Eingabereihenfolge, einschließlich doppelter Signaturen. Fehlende Transaktionen und Parserfehler einzelner Elemente werden als parserStatus: "ERROR"-Ergebnisse auf Elementebene zurückgegeben:

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "ERROR",
    "parserError": {
      "code": "transaction_not_found",
      "message": "transaction was not found"
    }
  }
]

Body des request

string[]

erforderlich

Zu parsende Transaktionssignaturen. Die maximale Batchgröße beträgt 100.

string

Standard:"confirmed"

Das commitment zum Abrufen der Transaktionen.

confirmed
finalized

boolean

Standard:"false"

Wenn true, füge jeder response das rohe payload der Solana-Transaktion als rawTransaction hinzu.

Hinweise

Das commitment processed wird nicht unterstützt.
rawTransaction wird nur zurückgegeben, wenn includeRawTransaction auf true gesetzt ist.
Fehlgeschlagene Transaktionsausführungen können trotzdem geparst werden. In diesem Fall ist parsed.transactionStatus auf ERROR gesetzt. Der Transaktionsfehler ist, sofern verfügbar, unter parsed.error enthalten.
Validierungsfehler auf request-Ebene geben statt Ergebnissen auf Elementebene eine Fehler-response zurück.

Geparster Transaktionsverlauf

POST /v1/parsed-events/transaction-history gibt den geparsten Transaktionsverlauf einer Adresse zurück. Unterstützt werden Paginierung, Grenzen für Signaturen, slots und Blockzeiten, Sortierreihenfolge sowie optionale Rohtransaktionen. Anders als beim veralteten Adress-endpoint von Enhanced Transactions werden request-Parameter in einem JSON-Body statt als Query-String-Parameter gesendet.

Body des request

string

erforderlich

Adresse, deren Transaktionsverlauf abgerufen werden soll.

number

Standard:"100"

Anzahl der zurückzugebenden Transaktionen. Muss zwischen 1 und 100 liegen.

string

Gib Transaktionen vor dieser Signatur zurück.

string

Gib Transaktionen nach dieser Signatur zurück.

string

Von der vorherigen response zurückgegebener Cursor.

string

Standard:"desc"

Sortierreihenfolge der zurückgegebenen Transaktionen.

asc
desc

string

Standard:"confirmed"

Das commitment zum Abrufen des Verlaufs.

confirmed
finalized

boolean

Standard:"false"

Wenn true, füge jeder response das rohe payload der Solana-Transaktion als rawTransaction hinzu.

object

Vergleichsgrenzen für slot. Jede Grenze ist optional: gt, gte, lt, lte.

object

Vergleichsgrenzen für die Blockzeit in Unix-Sekunden. Jede Grenze ist optional: gt, gte, lt, lte.

Paginierung

Responses haben die folgende Struktur. Jedes data-Element verwendet dasselbe TransactionResult-Format, das „Transaktionen parsen“ zurückgibt:

{
  "data": [
    {
      "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      "parserStatus": "OK",
      "parsed": {
        "slot": 433950192,
        "blockTime": 1784487060,
        "fee": 2005000,
        "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
        "transactionStatus": "OK",
        "nativeTransfers": [],
        "tokenTransfers": [],
        "summary": {
          "type": "swap",
          "description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
          "parsedData": {
            "type": "swap",
            "protocol": "jupiter",
            "kind": "swap",
            "in_amount": "1500000000000",
            "actual_out_amount": "64672839261950",
            "input_mint": "So11111111111111111111111111111111111111112",
            "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
            "inner_swaps": [
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "470229300000",
                "output_amount": "35579021038",
                "input_mint": "So11111111111111111111111111111111111111112",
                "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "1028270700000",
                "output_amount": "77798063361",
                "input_mint": "So11111111111111111111111111111111111111112",
                "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "14625643887",
                "output_amount": "8348494812168",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "35566391375",
                "output_amount": "20283004384731",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              },
              {
                "amm_program_id": "",
                "amm_program_name": null,
                "input_amount": "63185049137",
                "output_amount": "36041340065051",
                "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
              }
            ]
          }
        },
        "instructions": []
      }
    }
  ],
  "paginationToken": "433950192:0"
}

Übergib paginationToken im nächsten request erneut, um fortzufahren. Fehlt paginationToken, hat der Dienst das Ende des verfügbaren Seitenbereichs erreicht.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Parsed Events – Schnellstart

Schnellstart

Anleitungen

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

REST-Referenz

Transaktionen parsen

Body des request

Hinweise

Geparster Transaktionsverlauf

Body des request

Paginierung

​Schnellstart

​Anleitungen

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

​REST-Referenz

​Transaktionen parsen

​Body des request

​Hinweise

​Geparster Transaktionsverlauf

​Body des request

​Paginierung

Schnellstart

Anleitungen

REST-Referenz

Transaktionen parsen

Body des request

Hinweise

Geparster Transaktionsverlauf

Body des request

Paginierung