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

# GraphQL로 쿼리하기

> 형식화된 전송, 요약, 지시 필드를 포함하여 GraphQL로 구문 분석된 이벤트를 쿼리합니다.

## 개요

GraphQL 인터페이스는 두 가지 구문 분석된 이벤트 메서드를 노출합니다: `transactions`를 통한 트랜잭션 구문 분석과 `transactionsByAddress`를 통한 구문 분석된 트랜잭션 기록. 이는 [REST 엔드포인트](/docs/ko/parsed-events/quickstart#rest-레퍼런스)와 동일한 구문 분석된 트랜잭션 모델을 반환하며, 클라이언트가 필요한 필드만 선택할 수 있도록 합니다.

필드가 선택된 경우에만 GraphQL은 `rawTransaction`를 포함합니다. 동적 파서 페이로드는 디코딩된 지시 `args`, 트랜잭션 실행 `error`, 요약 `parsedData` 및 `rawTransaction`을 포함하여 JSON 스칼라로 유지됩니다.

## 트랜잭션 구문 분석

```graphql theme={"system"}
query ParseTransactions($signatures: [String!]!) {
  transactions(signatures: $signatures, commitment: CONFIRMED) {
    signature
    parserStatus
    parsed {
      slot
      blockTime
      fee
      feePayer
      transactionStatus
      nativeTransfers {
        fromUserAccount
        toUserAccount
        amount
      }
      tokenTransfers {
        fromUserAccount
        toUserAccount
        fromTokenAccount
        toTokenAccount
        rawTokenAmount
        decimals
        tokenStandard
        mint
      }
      summary {
        type
        description
        parsedData
      }
      instructions {
        topIxIdx
        innerIxIdx
        programId
        programName
        instructionName
        summary {
          type
          description
          parsedData
        }
        decoded {
          args
          accounts {
            name
            pubkey
            isSigner
            isWritable
          }
        }
      }
    }
    parserError {
      code
      message
    }
  }
}
```

변수:

```json theme={"system"}
{
  "signatures": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]
}
```

## 구문 분석된 트랜잭션 기록

```graphql theme={"system"}
query AddressHistory($address: String!) {
  transactionsByAddress(
    address: $address
    limit: 100
    sortOrder: DESC
    commitment: CONFIRMED
    filters: {
      slot: { gte: 300000000 }
    }
  ) {
    data {
      signature
      parserStatus
      parsed {
        slot
        blockTime
        nativeTransfers {
          fromUserAccount
          toUserAccount
          amount
        }
        tokenTransfers {
          fromUserAccount
          toUserAccount
          rawTokenAmount
          decimals
          mint
        }
      }
    }
    paginationToken
  }
}
```

변수:

```json theme={"system"}
{
  "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52"
}
```

## 쿼리 인수

### `transactions`

| 인수           | 유형           | 기본값         | 설명                          |
| ------------ | ------------ | ----------- | --------------------------- |
| `signatures` | `[String!]!` | -           | 구문 분석할 트랜잭션 서명입니다.          |
| `commitment` | `Commitment` | `CONFIRMED` | `CONFIRMED` 또는 `FINALIZED`. |

### `transactionsByAddress`

| 인수                | 유형                               | 기본값         | 설명                                  |
| ----------------- | -------------------------------- | ----------- | ----------------------------------- |
| `address`         | `String!`                        | -           | 트랜잭션 기록을 가져올 주소입니다.                 |
| `limit`           | `Int`                            | `100`       | 반환할 트랜잭션 수. `1`과 `100` 사이여야 합니다.    |
| `beforeSignature` | `String`                         | -           | 이 서명 이전의 트랜잭션을 반환합니다.               |
| `afterSignature`  | `String`                         | -           | 이 서명 이후의 트랜잭션을 반환합니다.               |
| `paginationToken` | `String`                         | -           | 쉐이프 `slot:transactionIndex`의 커서입니다. |
| `sortOrder`       | `SortOrder`                      | `DESC`      | `ASC` 또는 `DESC`.                    |
| `commitment`      | `Commitment`                     | `CONFIRMED` | `CONFIRMED` 또는 `FINALIZED`.         |
| `filters`         | `AddressTransactionFiltersInput` | -           | 선택적 `slot` 및 `time` 경계입니다.          |

## 원시 트랜잭션

원래 트랜잭션 JSON을 포함하기 위해 `rawTransaction`를 선택하십시오:

```graphql theme={"system"}
query ParseWithRaw($signatures: [String!]!) {
  transactions(signatures: $signatures) {
    signature
    rawTransaction
    parsed {
      slot
    }
  }
}
```

`rawTransaction`가 선택되지 않은 경우 서비스는 응답에 포함하지 않습니다.