> ## 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.

# 거래 구문 분석

> Helius Enhanced Transactions API를 사용하여 Solana 거래 서명을 구조화된 사람이 읽을 수 있는 데이터로 구문 분석합니다.

<Warning>
  Enhanced Transactions API는 유지보수 모드에 있는 레거시 제품입니다. 여전히 작동하며 이 페이지들은 사용할 수 있지만, 새 구문 분석 유형이나 기능 작업을 받지 않습니다. 후속 제품은 IDL 카탈로그를 통해 명령어를 디코딩하는 [Parsed Events](/docs/ko/parsed-events)이며, 현재 비공개 베타 중입니다. 거래 기록 및 백필을 위해 [`getTransactionsForAddress`](/docs/ko/rpc/gettransactionsforaddress)를 사용할 수 있으며, 사람이 읽을 수 있는 지갑 데이터를 위한 [Wallet API](/docs/ko/wallet-api/overview)를 사용할 수 있습니다.
</Warning>

## 개요

Parse Transactions 엔드포인트는 원시 거래 서명을 구조화된 사람이 읽을 수 있는 정보로 변환합니다. 명령어 데이터와 계정 목록을 수동으로 디코딩하는 대신, 전송, 스왑, NFT 활동 등에 대한 명확한 세부 정보를 받을 수 있습니다.

한 번의 호출로 최대 100개의 서명을 포함하여 `POST` 요청을 `/v0/transactions`에 보냅니다.

## 언제 사용해야 하는가

* 하나 이상의 거래 서명을 가지고 있으며, 사전 구문 분석된 사람이 읽을 수 있는 출력을 원할 때
* 사용자가 한 개의 거래 세부 정보를 보는데 사용합니다 (지갑, 탐색기).
* 자체 구문 분석기를 작성하지 않고 이벤트 요약 (SOL/토큰 전송, NFT 활동)이 필요할 때

새 빌드의 경우, [`getTransaction`](/docs/ko/api-reference/rpc/http/gettransaction)는 원시 거래를 반환하며, [`getTransactionsForAddress`](/docs/ko/rpc/gettransactionsforaddress)는 최신의 관련 이력 경로입니다.

## 빠른 시작

<Steps>
  <Step title="API 키 받기">
    [dashboard.helius.dev](https://dashboard.helius.dev)에서 가입하고 API 키를 복사하세요.
  </Step>

  <Step title="서명을 /v0/transactions로 POST하기">
    서명 배열을 `transactions` 본문 필드에 전달하십시오.

    <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="구문 분석된 응답 읽기">
    각 거래는 설명, 유형, 전송 및 이벤트 요약과 함께 반환됩니다. 아래 [응답](#응답)을 참조하세요.
  </Step>
</Steps>

## 요청 매개변수

<ParamField body="transactions" type="string[]" required>
  구문 분석할 거래 서명의 배열. 요청당 최대 100개의 서명.
</ParamField>

## 응답

각 구문 분석된 거래에는 사람이 읽을 수 있는 설명과 구조화된 전송 및 이벤트 데이터가 포함되어 있습니다:

```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
    }
  }
}
```

각 구문 분석된 거래에는 다음이 포함됩니다:

* **`description`** — 무슨 일이 있었는지에 대한 사람이 읽을 수 있는 요약.
* **`type`** — 거래 카테고리 (`TRANSFER`, `SWAP`, `NFT_SALE` 등).
* **`source`** — 거래를 실행한 프로그램.
* **`fee`** / **`feePayer`** — 램포트로의 거래 수수료 및 이를 지불한 계정.
* **`nativeTransfers`** — 계정 간 SOL 이동.
* **`tokenTransfers`** — SPL 토큰 이동.
* **`events`** — 고수준 이벤트 요약.
* **`slot`** / **`timestamp`** — 거래가 처리된 시점.

전체 필드 카탈로그 및 지원되는 거래 유형은 [Parse Transactions API 참조](/docs/ko/api-reference/enhanced-transactions/gettransactions)를 참조하세요.

## 다음 단계

<CardGroup cols={2}>
  <Card title="거래 이력" icon="clock-rotate-left" href="/docs/ko/enhanced-transactions/transaction-history">
    필터링 및 페이지 매김을 통해 주소의 사람이 읽을 수 있는 거래 이력을 가져오세요.
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/ko/rpc/gettransactionsforaddress">
    거래 이력 및 백필을 위한 최신 Helius 네이티브 대체품입니다.
  </Card>

  <Card title="지갑 API" icon="wallet" href="/docs/ko/wallet-api/overview">
    사람이 읽을 수 있는 지갑 데이터를 위한 REST 엔드포인트: 잔액, 이력, 전송.
  </Card>

  <Card title="데이터 얻기 개요" icon="database" href="/docs/ko/getting-data">
    Solana 데이터를 조회하기 위한 모든 Helius 옵션을 비교하십시오.
  </Card>
</CardGroup>