> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Phân tích giao dịch

> Phân tích chữ ký giao dịch Solana thành dữ liệu có cấu trúc, dễ đọc bằng Helius Enhanced Transactions API.

<Warning>
  Enhanced Transactions API là một sản phẩm cũ đang ở chế độ bảo trì. API này vẫn hoạt động và các trang này vẫn được cung cấp, nhưng không còn nhận thêm loại trình phân tích cú pháp hoặc tính năng mới. Sản phẩm kế nhiệm là [Sự kiện đã phân tích](/docs/vi/parsed-events), giải mã các chỉ thị thông qua danh mục IDL và có trong mọi gói với chi phí 10 tín dụng cho mỗi yêu cầu. [Hướng dẫn di chuyển](/docs/vi/parsed-events/guides/migrate-from-enhanced-transactions) trình bày từng bước chuyển đổi. Bạn cũng có thể sử dụng [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress) để truy xuất lịch sử giao dịch và nạp bù dữ liệu, cũng như [Wallet API](/docs/vi/wallet-api/overview) để lấy dữ liệu ví dễ đọc.
</Warning>

## Tổng quan

Điểm cuối Phân tích giao dịch chuyển đổi các chữ ký giao dịch thô thành thông tin có cấu trúc, dễ đọc. Thay vì tự giải mã dữ liệu chỉ thị và danh sách tài khoản, bạn nhận được thông tin chi tiết rõ ràng về các giao dịch chuyển khoản, hoán đổi, hoạt động NFT và nhiều nội dung khác.

Gửi yêu cầu `POST` đến `/v0/transactions` với tối đa 100 chữ ký cho mỗi lần gọi.

## Khi nào nên sử dụng

* Bạn có một hoặc nhiều chữ ký giao dịch và muốn nhận kết quả đầu ra đã được phân tích sẵn, dễ đọc.
* Bạn đang hiển thị thông tin chi tiết của một giao dịch cho người dùng (ví, trình khám phá).
* Bạn cần bản tóm tắt sự kiện (chuyển SOL/token, hoạt động NFT) mà không phải tự viết trình phân tích cú pháp.

Đối với các ứng dụng mới, [`getTransaction`](/docs/vi/api-reference/rpc/http/gettransaction) trả về giao dịch thô, còn [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress) là phương thức hiện đại để truy xuất lịch sử.

## Bắt đầu nhanh

<Steps>
  <Step title="Get your API key">
    Đăng ký tại [dashboard.helius.dev](https://dashboard.helius.dev) và sao chép khóa API của bạn.
  </Step>

  <Step title="POST signatures to /v0/transactions">
    Truyền một mảng chữ ký vào trường `transactions` trong phần thân.

    <Tabs>
      <Tab title="JavaScript">
        ```javascript theme={"system"}
        const parseTransaction = async () => {
          const url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY";

          const response = await fetch(url, {
            method: 'POST',
            headers: {
              'Content-Type': 'application/json',
            },
            body: JSON.stringify({
              transactions: ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"],
            }),
          });

          const data = await response.json();
          console.log("Parsed transaction:", data);
        };

        parseTransaction();
        ```
      </Tab>

      <Tab title="Python">
        ```python theme={"system"}
        import requests
        import json

        def parse_transaction():
            url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY"

            payload = {
                "transactions": ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"]
            }

            response = requests.post(url, json=payload)
            data = response.json()
            print("Parsed transaction:", data)

        parse_transaction()
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Read the parsed response">
    Mỗi giao dịch được trả về cùng với phần mô tả, loại, các giao dịch chuyển khoản và bản tóm tắt sự kiện. Xem phần [Phản hồi](#phản-hồi) bên dưới.
  </Step>
</Steps>

## Tham số yêu cầu

<ParamField body="transactions" type="string[]" required>
  Mảng chữ ký giao dịch cần phân tích. Tối đa 100 chữ ký cho mỗi yêu cầu.
</ParamField>

## Phản hồi

Mỗi giao dịch đã phân tích bao gồm phần mô tả dễ đọc cùng với dữ liệu chuyển khoản và sự kiện có cấu trúc:

```json theme={"system"}
{
  "description": "Transfer 0.1 SOL to FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
  "type": "TRANSFER",
  "source": "SYSTEM_PROGRAM",
  "fee": 5000,
  "feePayer": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
  "signature": "5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP",
  "slot": 171341028,
  "timestamp": 1674080473,
  "nativeTransfers": [
    {
      "fromUserAccount": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "toUserAccount": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 100000000
    }
  ],
  "events": {
    "sol": {
      "from": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "to": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 0.1
    }
  }
}
```

Mỗi giao dịch đã phân tích bao gồm:

* **`description`** — bản tóm tắt dễ đọc về những gì đã xảy ra.
* **`type`** — danh mục giao dịch (`TRANSFER`, `SWAP`, `NFT_SALE` và các loại khác).
* **`source`** — chương trình đã thực thi giao dịch.
* **`fee`** / **`feePayer`** — phí giao dịch tính bằng lamport và tài khoản đã thanh toán phí.
* **`nativeTransfers`** — các lượt chuyển SOL giữa các tài khoản.
* **`tokenTransfers`** — các lượt chuyển token SPL.
* **`events`** — bản tóm tắt sự kiện cấp cao.
* **`slot`** / **`timestamp`** — thời điểm giao dịch được xử lý.

Để xem danh mục trường đầy đủ và tất cả loại giao dịch được hỗ trợ, hãy tham khảo [tài liệu tham chiếu Parse Transactions API](/docs/vi/api-reference/enhanced-transactions/gettransactions).

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

<CardGroup cols={2}>
  <Card title="Transaction History" icon="clock-rotate-left" href="/docs/vi/enhanced-transactions/transaction-history">
    Truy xuất lịch sử giao dịch dễ đọc của một địa chỉ, với tính năng lọc và phân trang.
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/vi/rpc/gettransactionsforaddress">
    Giải pháp thay thế hiện đại, dành riêng cho Helius để truy xuất lịch sử giao dịch và nạp bù dữ liệu.
  </Card>

  <Card title="Wallet API" icon="wallet" href="/docs/vi/wallet-api/overview">
    Các điểm cuối REST cho dữ liệu ví dễ đọc: số dư, lịch sử và giao dịch chuyển khoản.
  </Card>

  <Card title="Getting Data overview" icon="database" href="/docs/vi/getting-data">
    So sánh mọi tùy chọn của Helius để truy vấn dữ liệu Solana.
  </Card>
</CardGroup>