Panduan Mulai Cepat Parsed Events

Baru menggunakan Parsed Events? Baca model mental Parsed Streams terlebih dahulu — Parsed Events mengembalikan instruksi terdekode yang sama melalui REST.

Mulai Cepat

Get Access

Parsed Events tersedia di semua paket dengan biaya 10 kredit per permintaan. Dapatkan kunci API Anda dari Dasbor Helius, lalu kirim permintaan ke https://mainnet.helius-rpc.com.Lakukan autentikasi dengan kunci API proyek Anda, yang diteruskan sebagai parameter kueri api-key.

Parse a Transaction

Teruskan tanda tangan dalam kolom isi transactions dari 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",
      ],
      rawTransaction: "none",
    }),
  });

  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"
    ],
    "rawTransaction": "none"
  }'

Read the Result

Respons berisi satu hasil untuk setiap tanda tangan yang diminta, sesuai urutan masukan. Setiap hasil mencakup signature, parserStatus, dan parsed atau 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
        }
      ]
    }
  }
]

Contoh ini dipangkas menjadi dua instruksi: transfer token terdekode di dalam rute dan instruksi AMM yang programnya dikenali oleh katalog tetapi tidak dapat didekode. Akibatnya, instructionName tetap bernilai null, sedangkan rawData dan rawAccounts tetap tersedia. Lihat Respons Terurai untuk mengetahui setiap kolom dan melihat contoh respons lengkap.

Fetch Address History

POST /v1/parsed-events/transaction-history mengembalikan hasil terurai yang sama seperti di atas untuk setiap transaksi yang melibatkan suatu alamat, secara default diurutkan dari yang terbaru:

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

Respons riwayat membungkus hasil dalam objek halaman. Teruskan kembali paginationToken dalam permintaan berikutnya untuk melanjutkan. Jika paginationToken tidak ada, layanan telah mencapai akhir rentang halaman yang tersedia.

Panduan

Fetch Pump.fun Mints

Telusuri per halaman setiap token yang telah diterapkan oleh dompet di Pump.fun.

Migrate from Enhanced Transactions

Pemetaan endpoint, parameter, dan respons dari API lama.

Referensi REST

Kedua metode REST menerima isi JSON melalui POST di bawah /v1/parsed-events/ pada https://mainnet.helius-rpc.com, dengan autentikasi menggunakan parameter kueri api-key. Isi permintaan menolak kolom yang tidak dikenal, sehingga kesalahan ketik akan menghasilkan kegagalan yang jelas, bukan diabaikan tanpa pemberitahuan.

Uraikan Transaksi

POST /v1/parsed-events/transactions mengambil transaksi Solana lengkap berdasarkan tanda tangan, mendekodenya dengan dekoder instruksi berbasis IDL yang sama dengan yang digunakan oleh Parsed Streams, dan mengembalikan satu TransactionResult untuk setiap tanda tangan yang diminta. Urutan respons sesuai dengan urutan masukan, termasuk tanda tangan duplikat. Transaksi yang tidak ditemukan dan kegagalan pengurai per item dikembalikan sebagai hasil parserStatus: "ERROR" tingkat item:

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

Isi permintaan

string[]

wajib

Tanda tangan transaksi yang akan diuraikan. Ukuran batch maksimum adalah 100.

string

default:"confirmed"

Tingkat komitmen yang digunakan saat mengambil transaksi.

confirmed
finalized

string

default:"none"

Pengodean transaksi mentah Solana yang dikembalikan sebagai rawTransaction pada setiap hasil, dalam bentuk getTransaction.

none
json
jsonParsed
base64

Catatan

Komitmen processed tidak didukung.
rawTransaction dihilangkan kecuali Anda menetapkan kolom permintaan rawTransaction ke json, jsonParsed, atau base64. includeRawTransaction: true yang lebih lama masih berfungsi sebagai alias untuk json.
Transaksi yang gagal dieksekusi tetap dapat diuraikan. Dalam kasus tersebut, parsed.transactionStatus adalah ERROR, dan galat transaksi ditampilkan pada parsed.error jika tersedia.
Galat validasi tingkat permintaan mengembalikan respons galat, bukan hasil tingkat item.

Riwayat Transaksi yang Diuraikan

POST /v1/parsed-events/transaction-history mengembalikan riwayat transaksi yang diuraikan untuk suatu alamat. Metode ini mendukung paginasi, batas tanda tangan, batas slot, batas waktu blok, urutan pengurutan, dan transaksi mentah opsional. Tidak seperti endpoint alamat Enhanced Transactions lama, parameter permintaan dikirim dalam isi JSON, bukan sebagai parameter string kueri.

Isi permintaan

string

wajib

Alamat yang riwayat transaksinya akan diambil.

number

default:"100"

Jumlah transaksi yang akan dikembalikan. Harus antara 1 dan 100.

string

Mengembalikan transaksi sebelum tanda tangan ini.

string

Mengembalikan transaksi setelah tanda tangan ini.

string

Kursor yang dikembalikan oleh respons sebelumnya.

string

default:"desc"

Urutan pengurutan untuk transaksi yang dikembalikan.

asc
desc

string

default:"confirmed"

Tingkat komitmen yang digunakan untuk mengambil riwayat.

confirmed
finalized

string

default:"succeeded"

Hasil eksekusi yang akan disertakan.

succeeded
failed
any

string

default:"none"

Menentukan apakah transaksi yang hanya merujuk pada akun token milik address, bukan address itu sendiri, akan disertakan. Banyak transfer token masuk hanya menyentuh akun token penerima.

none
balanceChanged
all

string

default:"none"

Pengodean transaksi mentah Solana yang dikembalikan sebagai rawTransaction pada setiap hasil, dalam bentuk getTransaction.

none
json
jsonParsed
base64

object

Batas perbandingan slot. Setiap batas bersifat opsional: gt, gte, lt, lte.

object

Batas perbandingan waktu blok dalam detik Unix. Setiap batas bersifat opsional: gt, gte, lt, lte.

Paginasi

Respons memiliki bentuk berikut. Setiap item data menggunakan format TransactionResult yang sama seperti yang dikembalikan oleh Parse Transactions:

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

Teruskan kembali paginationToken dalam permintaan berikutnya untuk melanjutkan. Jika paginationToken tidak ada, layanan telah mencapai akhir rentang halaman yang tersedia.

Mulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Pengiriman Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Panduan Mulai Cepat Parsed Events

Mulai Cepat

Panduan

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

Referensi REST

Uraikan Transaksi

Isi permintaan

Catatan

Riwayat Transaksi yang Diuraikan

Isi permintaan

Paginasi

​Mulai Cepat

​Panduan

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

​Referensi REST

​Uraikan Transaksi

​Isi permintaan

​Catatan

​Riwayat Transaksi yang Diuraikan

​Isi permintaan

​Paginasi

Mulai Cepat

Panduan

Referensi REST

Uraikan Transaksi

Isi permintaan

Catatan

Riwayat Transaksi yang Diuraikan

Isi permintaan

Paginasi