Bắt đầu nhanh với Parsed Events

Bạn mới làm quen với Parsed Events? Trước tiên, hãy đọc mô hình tư duy của Parsed Streams — Parsed Events trả về cùng các lệnh đã giải mã qua REST.

Bắt đầu nhanh

Get Access

Parsed Events có trên tất cả các gói với chi phí 10 tín dụng cho mỗi yêu cầu. Lấy khóa API từ Helius Dashboard và gửi yêu cầu đến https://mainnet.helius-rpc.com.Xác thực bằng khóa API của dự án, được truyền dưới dạng tham số truy vấn api-key.

Parse a Transaction

Truyền các chữ ký trong trường nội dung transactions của 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

Phản hồi chứa một kết quả cho mỗi chữ ký được yêu cầu, theo thứ tự đầu vào. Mỗi kết quả bao gồm signature, parserStatus và một trong hai trường parsed hoặc 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
        }
      ]
    }
  }
]

Ví dụ được rút gọn còn hai lệnh: một lần chuyển token đã giải mã bên trong tuyến và một lệnh AMM có chương trình được danh mục nhận diện nhưng không thể giải mã. Do đó, instructionName có giá trị null, trong khi rawData và rawAccounts vẫn khả dụng. Xem Phản hồi đã phân tích để biết tất cả các trường và xem ví dụ phản hồi đầy đủ.

Fetch Address History

POST /v1/parsed-events/transaction-history trả về các kết quả đã phân tích giống như trên cho mọi giao dịch liên quan đến một địa chỉ, mặc định sắp xếp mới nhất trước:

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

Phản hồi lịch sử bọc kết quả trong một đối tượng trang. Truyền lại paginationToken trong yêu cầu tiếp theo để tiếp tục. Nếu không có paginationToken, dịch vụ đã đến cuối phạm vi trang khả dụng.

Hướng dẫn

Fetch Pump.fun Mints

Duyệt qua từng trang để xem mọi token mà một ví đã triển khai trên Pump.fun.

Migrate from Enhanced Transactions

Ánh xạ endpoint, tham số và phản hồi từ API cũ.

Tài liệu tham chiếu REST

Cả hai phương thức REST đều chấp nhận nội dung JSON qua POST trong /v1/parsed-events/ tại https://mainnet.helius-rpc.com và được xác thực bằng tham số truy vấn api-key. Nội dung yêu cầu từ chối các trường không xác định, vì vậy lỗi đánh máy sẽ được báo rõ thay vì bị âm thầm bỏ qua.

Phân tích giao dịch

POST /v1/parsed-events/transactions truy xuất đầy đủ các giao dịch Solana theo chữ ký, giải mã chúng bằng cùng bộ giải mã lệnh dựa trên IDL được dùng cho Parsed Streams và trả về một TransactionResult cho mỗi chữ ký được yêu cầu. Thứ tự phản hồi khớp với thứ tự đầu vào, kể cả các chữ ký trùng lặp. Các giao dịch bị thiếu và lỗi bộ phân tích trên từng mục được trả về dưới dạng kết quả parserStatus: "ERROR" ở cấp mục:

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

Nội dung yêu cầu

string[]

bắt buộc

Các chữ ký giao dịch cần phân tích. Kích thước lô tối đa là 100.

string

mặc định:"confirmed"

Mức cam kết được sử dụng khi truy xuất giao dịch.

confirmed
finalized

string

mặc định:"none"

Kiểu mã hóa của giao dịch Solana thô được trả về dưới dạng rawTransaction trong mỗi kết quả, theo cấu trúc getTransaction.

none
json
jsonParsed
base64

Lưu ý

Mức cam kết processed không được hỗ trợ.
rawTransaction bị bỏ qua trừ khi bạn đặt trường yêu cầu rawTransaction thành json, jsonParsed hoặc base64. Giá trị cũ includeRawTransaction: true vẫn hoạt động như một bí danh của json.
Các giao dịch thực thi thất bại vẫn có thể được phân tích cú pháp. Trong trường hợp đó, parsed.transactionStatus là ERROR và lỗi giao dịch được cung cấp tại parsed.error khi có.
Lỗi xác thực ở cấp yêu cầu trả về phản hồi lỗi thay vì kết quả ở cấp mục.

Lịch sử giao dịch đã phân tích cú pháp

POST /v1/parsed-events/transaction-history trả về lịch sử giao dịch đã phân tích cú pháp cho một địa chỉ. Phương thức này hỗ trợ phân trang, giới hạn chữ ký, giới hạn slot, giới hạn thời gian khối, thứ tự sắp xếp và giao dịch thô tùy chọn. Không giống endpoint địa chỉ Giao dịch nâng cao cũ, các tham số yêu cầu được gửi trong phần thân JSON thay vì dưới dạng tham số chuỗi truy vấn.

Phần thân yêu cầu

string

bắt buộc

Địa chỉ cần truy xuất lịch sử giao dịch.

number

mặc định:"100"

Số lượng giao dịch cần trả về. Phải nằm trong khoảng từ 1 đến 100.

string

Trả về các giao dịch trước chữ ký này.

string

Trả về các giao dịch sau chữ ký này.

string

Con trỏ do phản hồi trước trả về.

string

mặc định:"desc"

Thứ tự sắp xếp cho các giao dịch được trả về.

asc
desc

string

mặc định:"confirmed"

Mức cam kết được sử dụng để truy xuất lịch sử.

confirmed
finalized

string

mặc định:"succeeded"

Kết quả thực thi cần bao gồm.

succeeded
failed
any

string

mặc định:"none"

Có bao gồm các giao dịch chỉ tham chiếu đến một tài khoản token thuộc sở hữu của address, chứ không phải chính address hay không. Nhiều giao dịch chuyển token đến chỉ tương tác với tài khoản token của người nhận.

none
balanceChanged
all

string

mặc định:"none"

Kiểu mã hóa của giao dịch Solana thô được trả về dưới dạng rawTransaction trong mỗi kết quả, theo cấu trúc getTransaction.

none
json
jsonParsed
base64

object

Các giới hạn so sánh slot. Mỗi giới hạn đều là tùy chọn: gt, gte, lt, lte.

object

Các giới hạn so sánh thời gian khối tính bằng giây Unix. Mỗi giới hạn đều là tùy chọn: gt, gte, lt, lte.

Phân trang

Các phản hồi có cấu trúc này. Mỗi mục data sử dụng cùng định dạng TransactionResult do Parse Transactions trả về:

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

Truyền lại paginationToken trong yêu cầu tiếp theo để tiếp tục. Nếu thiếu paginationToken, dịch vụ đã đi đến cuối phạm vi trang khả dụng.

Bắt đầu

Truyền dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch mua bán

Gửi giao dịch

Ví dưới dạng dịch vụ

Quyền riêng tư

Tài nguyên

Bắt đầu nhanh với Parsed Events