Skip to main content
Bắt đầu một đăng ký. Mỗi giao dịch đã xác nhận khớp với bộ lọc sẽ được gửi dưới dạng parsedTransactionNotification và đã được giải mã: mọi lệnh đều có đối số và tài khoản được đặt tên, cùng với phí, danh sách đầy đủ các khóa tài khoản, summary ở cấp giao dịch, cũng như các giao dịch chuyển SOL và token.

Điểm cuối

Parsed Streams có sẵn trên tất cả các gói và được cung cấp qua điểm cuối Gatekeeper, cùng máy chủ với lưu lượng RPC và WebSocket của Helius:
  • wss://beta.helius-rpc.com/?api-key=<API_KEY>

Xác thực

string
bắt buộc
Khóa API Helius của bạn, được truyền dưới dạng tham số truy vấn api-key hoặc tiêu đề x-api-key. Khóa bị thiếu hoặc không hợp lệ sẽ bị từ chối với HTTP 401.

Nội dung yêu cầu

array
bắt buộc
Các trường không xác định ở bất kỳ đâu trong bộ lọc hoặc tùy chọn đều bị từ chối với -32602 thay vì bị bỏ qua âm thầm, vì vậy lỗi chính tả sẽ được báo rõ thay vì không khớp với dữ liệu nào.

Phản hồi

integer
ID đăng ký (cần thiết để hủy đăng ký)

Thông báo

Mỗi giao dịch khớp sẽ tạo một thông báo cho mỗi đăng ký. Bên trong params.result.value:
  • transaction — ngữ cảnh đầy đủ: chữ ký, slot, phí (lamport), danh sách accountKeys đầy đủ, status/error, summary ở cấp giao dịch, cùng nativeTransfers và tokenTransfers đã trích xuất.
  • instructions — mọi lệnh theo thứ tự thực thi, được xác định vị trí bằng instructionIndex, innerInstructionIndex và stackHeight. Các lệnh đã giải mã chứa decoded.args và decoded.accounts có tên (snake_case, giá trị u64 ở dạng chuỗi); các lệnh chưa giải mã chứa rawData và rawAccounts thay thế.
  • matchedIndexes — các chỉ mục trỏ vào instructions, cho biết những lệnh nào thực sự khớp với bộ lọc. Với details: "matched", mảng chỉ chứa các kết quả khớp và không có matchedIndexes; với details: "raw", mỗi lệnh đã khớp được rút gọn thành vị trí, programId và blob data dạng base58.
Để xem diễn giải từng trường trong payload thông báo, hãy tham khảo tài liệu tham chiếu giao thức bắt đầu nhanh.

Quản lý đăng ký

result từ phản hồi đăng ký là cùng một số xuất hiện trong params.subscription trên mọi thông báo từ đăng ký đó. Hãy lưu số này — bạn cần nó để hủy đăng ký. Một dự án có thể duy trì tối đa 5 kết nối đồng thời ở gói Free, 10 ở gói Developer và 50 ở các gói Business và Professional. Giới hạn này được dùng chung cho tất cả các khóa API của dự án, với tối đa 25 đăng ký trên mỗi kết nối. Xem phần tổng quan để biết tất cả các giới hạn.