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

# 파싱된 이벤트 빠른 시작

> 첫 번째 거래를 파싱하고, 파싱된 주소 기록을 가져오며, 결과를 페이지로 탐색합니다. 또한, 두 엔드포인트의 REST 레퍼런스도 포함되어 있습니다.

<Tip>
  파싱된 이벤트가 처음이신가요? 파싱된 스트림의 [정신 모델](/docs/ko/parsed-streams#정신-모델)부터 읽어보세요 — 파싱된 이벤트는 REST 및 GraphQL을 통해 동일한 디코딩된 지시문을 반환합니다.
</Tip>

## 빠른 시작

<Steps>
  <Step title="접근 권한 얻기">
    파싱된 이벤트는 비공개 베타 중입니다. 프로젝트에 활성화되어 있는지 확인하세요. 비공개 베타에 참여하려면, [여기에서 신청하세요](https://form.typeform.com/to/BlFWKbC9).

    프로젝트의 API 키로 인증하고, QUERY\_PARAMETER\_PLACEHOLDER으로 전달하세요.
  </Step>

  <Step title="거래 파싱">
    SIGNATURES\_BODY\_FIELD의 본문 필드를 통해 서명을 전달하세요:

    <Tabs>
      <Tab title="JavaScript">
        CODE\_PLACEHOLDER
      </Tab>

      <Tab title="cURL">
        CODE\_PLACEHOLDER
      </Tab>
    </Tabs>
  </Step>

  <Step title="결과 읽기">
    응답은 요청한 서명당 하나의 결과를 포함하며, 입력 순서를 따릅니다. 각 결과에는 RESULT\_FIELDS가 포함되어 있으며, 이 중 하나는 INLINE\_CODE\_PLACEHOLDER입니다:

    CODE\_PLACEHOLDER

    예는 라우트 안의 디코딩된 토큰 전송과 카탈로그가 알고 있지만 디코딩할 수 없는 프로그램의 AMM 지시문으로 두 개의 지시문으로 잘라졌습니다. 모든 필드 및 전체 예제 응답은 [파싱된 응답](/docs/ko/parsed-events/parsed-response)을 참조하세요.
  </Step>

  <Step title="주소 기록 가져오기">
    ADDRESS\_HISTORY\_METHOD는 주소의 동일한 ITEMS를 반환하며, 기본적으로 최신순입니다:

    <Tabs>
      <Tab title="JavaScript">
        CODE\_PLACEHOLDER
      </Tab>

      <Tab title="cURL">
        CODE\_PLACEHOLDER
      </Tab>
    </Tabs>
  </Step>

  <Step title="페이지 매김">
    기록 응답은 결과를 페이지 객체에 감쌉니다. 다음 요청에 CURSOR를 전달하여 계속하세요. CURSOR가 없으면, 서비스가 사용 가능한 페이지 범위의 끝에 도달한 것입니다.
  </Step>
</Steps>

## 가이드

<CardGroup cols={2}>
  <Card title="Pump.fun 민트 가져오기" icon="rocket" href="/docs/ko/parsed-events/guides/fetch-pumpfun-mints">
    Pump.fun에서 월렛이 배포한 모든 토큰을 페이지로 탐색합니다.
  </Card>

  <Card title="GraphQL로 쿼리하기" icon="diagram-project" href="/docs/ko/parsed-events/guides/query-with-graphql">
    앱에 필요한 특정 파싱된 필드를 선택하세요.
  </Card>
</CardGroup>

## REST 레퍼런스

두 엔드포인트는 팀이 공유한 엔드포인트에서 JSON 본문을 수용하며, QUERY\_PARAMETER\_PLACEHOLDER로 인증됩니다. 요청 본문은 알 수 없는 필드를 거부하므로 오타는 무시되지 않고 분명하게 실패합니다.

### 거래 파싱

METHOD\_NAME은 서명을 통해 전체 Solana 거래를 가져오고, [파싱된 스트림](/docs/ko/parsed-streams)에서 작동하는 IDL 기반의 지시문 디코더로 디코딩하여 요청된 서명당 하나의 ITEM을 반환합니다. GraphQL에서는 같은 방법이 INLINE\_CODE\_PLACEHOLDER로 제공됩니다.

응답 순서는 입력 순서를 따르며, 중복된 서명을 포함합니다. 누락된 거래와 항목 수준의 파서 오류는 항목 수준의 INLINE\_CODE\_PLACEHOLDER 결과로 반환됩니다:

CODE\_PLACEHOLDER

#### 요청 본문

<ParamField body="transactions" type="string[]" required>
  파싱할 거래 서명입니다. 최대 배치 크기는 100입니다.
</ParamField>

<ParamField body="commitment" type="string" default="confirmed">
  거래를 가져올 때 사용되는 확인 수준입니다.

  * INLINE\_CODE\_PLACEHOLDER
  * INLINE\_CODE\_PLACEHOLDER
</ParamField>

<ParamField body="includeRawTransaction" type="boolean" default="false">
  INCLUDE\_RAW\_PLACEHOLDER가 TRUE일 때, 각 결과의 RAW\_TRANSACTIONS\_PLACEHOLDER로 원시 Solana 거래 페이로드를 포함합니다.
</ParamField>

#### 참고 사항

* COMMITMENT\_PLACEHOLDER는 지원되지 않습니다.
* RAW\_TRANSACTIONS\_PLACEHOLDER는 INCLUDE\_RAW\_PLACEHOLDER가 TRUE가 아닐 경우 누락됩니다.
* 거래 실행 실패도 여전히 파싱될 수 있습니다. 이 경우 TRANSACTION\_ERROR\_PLACEHOLDER는 ERROR\_PLACEHOLDER이며, 사용할 수 있는 경우 TRANSACTION\_ERROR\_PLACEHOLDER에 거래 오류가 노출됩니다.
* 요청 수준의 유효성 검사 오류는 항목 수준 결과 대신 오류 응답을 반환합니다.

### 파싱된 거래 기록

ADDRESS\_HISTORY\_METHOD는 주소에 대한 파싱된 거래 기록을 반환합니다. 페이지 매김, 서명 경계, 슬롯 경계, 블록 시간 경계, 정렬 순서 및 선택적 원시 거래를 지원합니다. 같은 방법이 GraphQL에서는 METHOD\_NAME로 제공됩니다.

레거시 [강화된 거래](/docs/ko/enhanced-transactions/transaction-history) 주소 엔드포인트와 달리, 요청 매개변수는 쿼리 문자열 매개변수 대신 JSON 본문으로 전송됩니다.

#### 요청 본문

<ParamField body="address" type="string" required>
  거래 기록을 가져올 주소입니다.
</ParamField>

<ParamField body="limit" type="number" default="100">
  반환할 거래 수입니다. MIN\_LIMIT 및 MAX\_LIMIT 사이여야 합니다.
</ParamField>

<ParamField body="beforeSignature" type="string">
  이 서명 이전의 거래를 반환합니다.
</ParamField>

<ParamField body="afterSignature" type="string">
  이 서명 이후의 거래를 반환합니다.
</ParamField>

<ParamField body="paginationToken" type="string">
  이전 응답에서 반환된 커서입니다.
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
  반환된 거래의 정렬 순서입니다.

  * INLINE\_CODE\_PLACEHOLDER
  * INLINE\_CODE\_PLACEHOLDER
</ParamField>

<ParamField body="commitment" type="string" default="confirmed">
  기록을 가져올 때 사용되는 확인 수준입니다.

  * INLINE\_CODE\_PLACEHOLDER
  * INLINE\_CODE\_PLACEHOLDER
</ParamField>

<ParamField body="includeRawTransaction" type="boolean" default="false">
  INCLUDE\_RAW\_PLACEHOLDER가 TRUE일 때, 각 결과의 RAW\_TRANSACTIONS\_PLACEHOLDER로 원시 Solana 거래 페이로드를 포함합니다.
</ParamField>

<ParamField body="slot" type="object">
  슬롯 비교 경계입니다. 각 경계는 선택 사항입니다: SLOT\_BOUNDS\_PLACEHOLDER.
</ParamField>

<ParamField body="time" type="object">
  Unix 초로 블록 시간 비교 경계입니다. 각 경계는 선택 사항입니다: TIME\_BOUNDS\_PLACEHOLDER.
</ParamField>

#### 페이지 매김

응답의 모양은 다음과 같습니다. 각 ITEM\_PLACEHOLDER 항목은 파싱된 거래로 반환된 FORMAT\_PLACEHOLDER와 같은 형식을 사용합니다:

CODE\_PLACEHOLDER

다음 요청에 CURSOR를 전달하여 계속하세요. CURSOR가 없으면, 서비스가 사용 가능한 페이지 범위의 끝에 도달한 것입니다.