Skip to main content
Helius cung cấp khả năng hỗ trợ hàng đầu cho các tác nhân AI xây dựng trên Solana. Từ việc tạo tài khoản theo chương trình đến truyền dữ liệu theo thời gian thực, tác nhân có thể khai thác toàn bộ sức mạnh của Helius mà không cần bất kỳ sự can thiệp thủ công nào.
  • Helius MCP — 10 công cụ được định tuyến, hỗ trợ truy vấn blockchain, gửi giao dịch, truyền dữ liệu và nhiều chức năng khác
  • Plugin Claude Code — Plugin Claude Code chính thức đầu tiên và hiện là duy nhất từ một công ty tiền mã hóa. Chỉ cần cài đặt một lần: máy chủ MCP + kỹ năng + tệp tham chiếu
  • Kỹ năng — Bộ hướng dẫn chuyên sâu cho Claude: Xây dựng, Phantom, Jupiter, DFlow, OKX, SVM
  • TypeScript SDK — Các phương thức an toàn kiểu cho tất cả API của Helius
  • Rust SDK — Rust SDK hiệu năng cao cho API của Helius
  • Helius CLI — Quản lý tài khoản và viết tập lệnh shell
Phiên bản mà máy có thể đọc của phần này có tại agents/llms.txt để tác nhân AI sử dụng.

MCP so với CLI

Máy chủ Helius MCP là cách được đề xuất để tác nhân AI tương tác với Helius. Máy chủ này cung cấp 10 công cụ được định tuyến, cho phép AI truy cập trực tiếp và có cấu trúc vào Solana — không cần lệnh shell, không cần phân tích đầu ra và không cần gọi API thủ công.
Bắt đầu với MCP. Nếu công cụ AI của bạn hỗ trợ MCP (Claude Code, Cursor, Claude Desktop, v.v.), hãy sử dụng máy chủ MCP hoặc Plugin Claude Code. CLI hữu ích cho việc viết tập lệnh shell và CI/CD, nhưng MCP mang lại trải nghiệm liền mạch hơn cho các quy trình làm việc dựa trên AI — AI gọi trực tiếp các công cụ thay vì khởi chạy lệnh shell và phân tích đầu ra.

Bắt đầu nhanh: Đăng ký tác nhân

Tác nhân có thể tạo tài khoản Helius và nhận khóa API bằng Helius CLI:
Khi thành công (--resume hoặc --pay), tác nhân của bạn sẽ nhận được khóa API, các điểm cuối RPC và 1.000.000 tín dụng. Xem hướng dẫn CLI đầy đủ để biết chi tiết.

Xác thực

Mọi yêu cầu API của Helius đều yêu cầu khóa API được truyền dưới dạng tham số truy vấn:
Nối giá trị này vào bất kỳ điểm cuối RPC hoặc API nào. Ví dụ: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Lấy khóa API từ Bảng điều khiển Helius hoặc theo chương trình thông qua Helius CLI.
Sử dụng Gatekeeper để giảm độ trễ — Gatekeeper (Beta) loại bỏ Cloudflare khỏi đường dẫn trọng yếu, giúp giảm thời gian phản hồi từ hàng chục đến hàng trăm mili giây. Vẫn cùng khóa API, cùng phương thức — chỉ cần thay đổi điểm cuối:
Hỗ trợ tất cả phương thức RPC, DAS, WebSocket, ZK Compression, Priority Fee và Enhanced Transaction. Xem hướng dẫn di chuyển để biết chi tiết.

Hướng dẫn dành riêng cho API của Helius

Hãy sử dụng các API được Helius tối ưu hóa này thay vì nối chuỗi các phương thức RPC Solana tiêu chuẩn:

Quy trình làm việc được đề xuất

Khi sử dụng Số dư Wallet API để tóm tắt danh mục đầu tư: API đang ở giai đoạn beta; token bị giới hạn ở 100 token mỗi trang; NFT bị loại trừ trừ khi dùng showNfts=true (tối đa 100 NFT và chỉ trên trang đầu tiên); pricePerToken và usdValue có thể là null; giá là ước tính theo giờ, không phải giá thị trường theo thời gian thực; totalUsdValue áp dụng cho trang hiện tại, không phải toàn bộ danh mục đầu tư được phân trang; mỗi yêu cầu tốn 100 tín dụng. Hãy sử dụng DAS có phân trang để lấy đầy đủ kho NFT và siêu dữ liệu — không coi Balances là kho NFT đầy đủ.

Tham khảo nhanh về giới hạn tốc độ

Giới hạn tốc độ phụ thuộc vào gói của bạn. Tác nhân bắt đầu ở cấp Agent với 1.000.000 tín dụng. Cấp Agent yêu cầu thanh toán $1 để ngăn chặn hành vi lạm dụng. Để biết giới hạn tốc độ chi tiết cho từng API, hãy xem Giới hạn tốc độ.

Tín dụng cho mỗi lệnh gọi API

Để xem thông tin phân tích đầy đủ, hãy xem Tín dụng.

Thử lại và xử lý lỗi

Mã trạng thái HTTP

Mẫu thử lại

Theo dõi mức sử dụng tín dụng

Tham khảo nhanh

  • RPC Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC Mainnet (Gatekeeper Beta): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • RPC Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS Mainnet: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS Mainnet (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • WSS Devnet: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Điểm cuối Sender: https://sender.helius-rpc.com/fast
  • Máy chủ MCP: https://www.helius.dev/docs/mcp
  • Bảng điều khiển: dashboard.helius.dev
  • Trạng thái: helius.statuspage.io