Khởi động nhanh với dữ liệu

Thiết lập nhanh

Mỗi ví dụ dưới đây chỉ cần khóa Helius API của bạn từ dashboard.helius.dev. Thay thế YOUR_API_KEY, sau đó chọn phương thức phù hợp với dữ liệu bạn muốn truy xuất:

Bạn muốn	Sử dụng	Trả về
Toàn bộ lịch sử giao dịch của một địa chỉ	getTransactionsForAddress	Các giao dịch đã giải mã của một địa chỉ
Toàn bộ lịch sử chuyển tài sản của một địa chỉ	getTransfersByAddress	Các lượt chuyển token và SOL gốc của một địa chỉ
Token, NFT và tài sản thuộc sở hữu của một ví	DAS API — `getAssetsByOwner`	Tài sản kèm siêu dữ liệu, thông tin sở hữu và số dư
Số dư ví kèm giá trị USD qua REST	Wallet API — `/balances`	Số dư token và NFT kèm định giá bằng USD

Lựa chọn 1: Nạp bù lịch sử giao dịch (getTransactionsForAddress)

getTransactionsForAddress trả về toàn bộ lịch sử giao dịch đã giải mã của một địa chỉ chỉ bằng một phương thức — đây là cách nhanh nhất để nạp bù dữ liệu phục vụ việc lập chỉ mục. Truyền địa chỉ trước, sau đó truyền một đối tượng tùy chọn chứa các bộ lọc không bắt buộc.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransactionsForAddress',
    params: [
      '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      {
        transactionDetails: 'full',
        sortOrder: 'desc',
        limit: 100,
      },
    ],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transactions`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        {"transactionDetails": "full", "sortOrder": "desc", "limit": 100},
    ],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transactions")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
      "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      { "transactionDetails": "full", "sortOrder": "desc", "limit": 100 }
    ]
  }'

getTransactionsForAddress guide

Bộ lọc, phân trang, định dạng phản hồi và các phương pháp hay nhất.

Indexing guide

Xây dựng, nạp bù và duy trì chỉ mục Solana luôn cập nhật.

Lựa chọn 2: Lấy lịch sử chuyển tài sản (getTransfersByAddress)

getTransfersByAddress trả về lịch sử chuyển token và SOL gốc đã được phân tích cú pháp cho một địa chỉ — ở cấp độ lượt chuyển thay vì cấp độ giao dịch, sẵn sàng để đối soát. Truyền địa chỉ và thêm một đối tượng tùy chọn để áp dụng bộ lọc.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransfersByAddress',
    params: ['86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY'],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transfers`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transfers")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"]
  }'

getTransfersByAddress guide

Các loại lượt chuyển, bộ lọc, đối soát và định dạng phản hồi.

getTransfersByAddress reference

Đầy đủ tham số và lược đồ phản hồi.

Lựa chọn 3: Lấy tài sản của ví (DAS API)

DAS API trả về NFT, token có thể thay thế và tài sản nén thuộc sở hữu của một ví chỉ trong một lệnh gọi — đây là điểm khởi đầu phổ biến nhất cho ví, chế độ xem danh mục đầu tư và hoạt động phân tích.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAssetsByOwner',
    params: {
      ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      page: 1,
      limit: 1000,
      options: {
        showFungible: true,
        showNativeBalance: true,
      },
    },
  }),
});

const { result } = await response.json();
console.log(`Found ${result.total} assets`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
        "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "page": 1,
        "limit": 1000,
        "options": {
            "showFungible": True,
            "showNativeBalance": True,
        },
    },
}
result = requests.post(url, json=payload).json()["result"]
print(f"Found {result['total']} assets")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
      "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      "page": 1,
      "limit": 1000,
      "options": {
        "showFungible": true,
        "showNativeBalance": true
      }
    }
  }'

DAS API overview

Tất cả phương thức tài sản, các loại tài sản đặc biệt và các phương pháp hay nhất.

getAssetsByOwner reference

Đầy đủ tham số và lược đồ phản hồi.

Lựa chọn 4: Lấy số dư ví qua REST (Wallet API)

Wallet API là một REST API cấp cao. Điểm cuối số dư trả về lượng token và NFT mà ví đang nắm giữ cùng giá trị bằng USD — không cần lớp bao JSON-RPC.

const address = '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY';
const response = await fetch(
  `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`,
);

const data = await response.json();
console.log(`Current page value: $${data.totalUsdValue}`);

import requests

address = "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
url = f"https://api.helius.xyz/v1/wallet/{address}/balances"
data = requests.get(url, headers={"X-Api-Key": "YOUR_API_KEY"}).json()
print(f"Current page value: ${data['totalUsdValue']}")

curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"

Wallet API overview

Tất cả điểm cuối ví, phương thức xác thực và đơn vị.

Wallet Balances reference

Các tham số truy vấn và lược đồ phản hồi đầy đủ.

Các bước tiếp theo

Getting Data overview

So sánh tất cả API dữ liệu và chọn API phù hợp với trường hợp sử dụng của bạn.

API Reference

Tài liệu đầy đủ về các phương thức và điểm cuối.

Bạn cần trợ giúp? Tham gia Discord của chúng tôi hoặc xem tài liệu hỗ trợ.

Bắt đầu

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

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

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

Quyền riêng tư

Tài nguyên

Khởi động nhanh với dữ liệu

Thiết lập nhanh

Lựa chọn 1: Nạp bù lịch sử giao dịch (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

Lựa chọn 2: Lấy lịch sử chuyển tài sản (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

Lựa chọn 3: Lấy tài sản của ví (DAS API)

DAS API overview

getAssetsByOwner reference

Lựa chọn 4: Lấy số dư ví qua REST (Wallet API)

Wallet API overview

Wallet Balances reference

Các bước tiếp theo

Getting Data overview

API Reference

​Thiết lập nhanh

​Lựa chọn 1: Nạp bù lịch sử giao dịch (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

​Lựa chọn 2: Lấy lịch sử chuyển tài sản (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

​Lựa chọn 3: Lấy tài sản của ví (DAS API)

DAS API overview

getAssetsByOwner reference

​Lựa chọn 4: Lấy số dư ví qua REST (Wallet API)

Wallet API overview

Wallet Balances reference

​Các bước tiếp theo

Getting Data overview

API Reference

Thiết lập nhanh

Lựa chọn 1: Nạp bù lịch sử giao dịch (getTransactionsForAddress)

Lựa chọn 2: Lấy lịch sử chuyển tài sản (getTransfersByAddress)

Lựa chọn 3: Lấy tài sản của ví (DAS API)

Lựa chọn 4: Lấy số dư ví qua REST (Wallet API)

Các bước tiếp theo