파싱된 이벤트 빠른 시작

파싱된 이벤트가 처음이신가요? 파싱된 스트림의 정신 모델부터 읽어보세요 — 파싱된 이벤트는 REST 및 GraphQL을 통해 동일한 디코딩된 지시문을 반환합니다.

빠른 시작

Get Access

Parsed Events는 유료 플랜에서 사용할 수 있는 오픈 베타입니다. Helius Dashboard에서 API 키를 받아 https://mainnet.helius-rpc.com에 요청을 보냅니다.프로젝트의 API 키로 인증하며, 이는 api-key 쿼리 매개변수로 전달됩니다.

Parse a Transaction

서명을 POST /v1/parsed-events/transactions의 transactions 본문 필드에 전달합니다:

JavaScript
cURL

const parseTransactions = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY";

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

  const data = await response.json();
  console.log(data);
};

parseTransactions();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "transactions": [
      "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
    ],
    "includeRawTransaction": false
  }'

결과 읽기

응답은 요청한 서명당 하나의 결과를 포함하며, 입력 순서를 따릅니다. 각 결과에는 RESULT_FIELDS가 포함되어 있으며, 이 중 하나는 INLINE_CODE_PLACEHOLDER입니다:

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "OK",
    "parsed": {
      "slot": 433950192,
      "blockTime": 1784487060,
      "fee": 2005000,
      "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "transactionStatus": "OK",
      "nativeTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "amount": 1500000000000
        }
      ],
      "tokenTransfers": [
        {
          "fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
          "toUserAccount": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
          "fromTokenAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
          "toTokenAccount": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
          "rawTokenAmount": 1498500000000,
          "decimals": 9,
          "tokenStandard": "Fungible",
          "mint": "So11111111111111111111111111111111111111112"
        }
      ],
      "summary": {
        "type": "swap",
        "description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
        "parsedData": {
          "type": "swap",
          "protocol": "jupiter",
          "kind": "swap",
          "in_amount": "1500000000000",
          "actual_out_amount": "64672839261950",
          "input_mint": "So11111111111111111111111111111111111111112",
          "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
          "inner_swaps": [
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "470229300000",
              "output_amount": "35579021038",
              "input_mint": "So11111111111111111111111111111111111111112",
              "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "1028270700000",
              "output_amount": "77798063361",
              "input_mint": "So11111111111111111111111111111111111111112",
              "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "14625643887",
              "output_amount": "8348494812168",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "35566391375",
              "output_amount": "20283004384731",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            },
            {
              "amm_program_id": "",
              "amm_program_name": null,
              "input_amount": "63185049137",
              "output_amount": "36041340065051",
              "input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
            }
          ]
        }
      },
      "instructions": [
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 2,
          "stackHeight": 3,
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "rawAccounts": [
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE"
          ],
          "rawData": "3JvpRSxKFyKV",
          "summary": {
            "type": "transfer",
            "description": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE transferred 470.2293 SOL from 7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE to 8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "parsedData": null
          },
          "programName": "token",
          "instructionName": "transfer",
          "decoded": {
            "args": {
              "amount": "470229300000"
            },
            "accounts": [
              {
                "name": "source_account",
                "pubkey": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "destination_account",
                "pubkey": "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
                "isSigner": false,
                "isWritable": true
              },
              {
                "name": "owner_or_delegate",
                "pubkey": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
                "isSigner": true,
                "isWritable": false
              }
            ]
          }
        },
        {
          "instructionIndex": 5,
          "innerInstructionIndex": 1,
          "stackHeight": 2,
          "programId": "BiSoNHVpsVZW2F7rx2eQ59yQwKxzU5NvBcmKshCSUypi",
          "rawAccounts": [
            "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
            "8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
            "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
            "2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
            "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
            "EpdaePzdqRkMtdZJquVPUWgyoJ5YEEpYALki6dv9VBrt",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
            "Sysvar1nstructions1111111111111111111111111",
            "J1to1yufRnoWn81KYg1XkTWzmKjnYSnmE2VY8DGUJ9Qv"
          ],
          "rawData": "67t827t7UwAMHa6U18HnBBLj",
          "summary": null,
          "programName": "bison_fi",
          "instructionName": null,
          "decoded": null
        }
      ]
    }
  }
]

예제는 두 개의 명령으로 축소됩니다: 경로 내에서 디코딩된 토큰 전송과 카탈로그가 인식하지만 디코딩할 수 없는 AMM 명령으로, instructionName는 null로 남고, rawData 및 rawAccounts는 여전히 사용 가능합니다. 모든 필드 및 전체 예제 응답은 파싱된 응답을 참조하십시오.

주소 기록 가져오기

POST /v1/parsed-events/transaction-history는 주소에 영향을 미친 모든 거래에 대해 위와 동일한 파싱된 결과를 반환하며, 기본적으로 최신 순입니다.

JavaScript
cURL

const fetchTransactionHistory = async () => {
  const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      address: "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      limit: 100,
      sortOrder: "desc",
      commitment: "confirmed",
    }),
  });

  const page = await response.json();
  console.log(page.data);
  console.log(page.paginationToken);
};

fetchTransactionHistory();

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
      "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
      "limit": 100,
      "sortOrder": "desc",
      "commitment": "confirmed"
    }'

페이지 매김

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

가이드

Pump.fun 민트 가져오기

Pump.fun에서 지갑이 배포한 모든 토큰을 페이지를 통해 확인합니다.

GraphQL로 쿼리하기

앱에서 필요한 파싱된 필드만 정확히 선택하세요.

향상된 거래에서 마이그레이션

레거시 API의 엔드포인트, 매개변수 및 응답 매핑.

REST 레퍼런스

두 REST 메서드는 /v1/parsed-events/ 아래의 POST를 통해 JSON 본문을 수락하며, api-key 쿼리 매개변수로 인증됩니다. 요청 본문은 알 수 없는 필드를 거부하여 오타가 조용히 무시되지 않고 명확히 실패하도록 합니다. GraphQL 쿼리는 POST /v1/parsed-events/graphql로 이동합니다.

거래 파싱

POST /v1/parsed-events/transactions는 서명을 통해 전체 Solana 트랜잭션을 가져오고, Parsed Streams를 구동하는 동일한 IDL 기반 명령 디코더로 이를 디코딩하며, 요청된 서명당 하나의 TransactionResult를 반환합니다. 동일한 메서드는 GraphQL에서 transactions로 사용 가능합니다. 응답 순서는 입력 순서를 따르며, 중복된 서명을 포함합니다. 누락된 거래와 항목 수준의 파서 오류는 항목 수준의 INLINE_CODE_PLACEHOLDER 결과로 반환됩니다: CODE_PLACEHOLDER

요청 본문

string[]

필수

파싱할 거래 서명입니다. 최대 배치 크기는 100입니다.

string

기본값:"confirmed"

거래를 가져올 때 사용되는 확인 수준입니다.

INLINE_CODE_PLACEHOLDER
INLINE_CODE_PLACEHOLDER

boolean

기본값:"false"

INCLUDE_RAW_PLACEHOLDER가 TRUE일 때, 각 결과의 RAW_TRANSACTIONS_PLACEHOLDER로 원시 Solana 거래 페이로드를 포함합니다.

참고 사항

COMMITMENT_PLACEHOLDER는 지원되지 않습니다.
RAW_TRANSACTIONS_PLACEHOLDER는 INCLUDE_RAW_PLACEHOLDER가 TRUE가 아닐 경우 누락됩니다.
거래 실행 실패도 여전히 파싱될 수 있습니다. 이 경우 TRANSACTION_ERROR_PLACEHOLDER는 ERROR_PLACEHOLDER이며, 사용할 수 있는 경우 TRANSACTION_ERROR_PLACEHOLDER에 거래 오류가 노출됩니다.
요청 수준의 유효성 검사 오류는 항목 수준 결과 대신 오류 응답을 반환합니다.

파싱된 거래 기록

POST /v1/parsed-events/transaction-history는 주소의 파싱된 트랜잭션 기록을 반환합니다. 이는 페이지 매김, 서명 범위, 슬롯 범위, 블록 시간 범위, 정렬 순서 및 선택적 원시 트랜잭션을 지원합니다. 동일한 메서드는 GraphQL에서 transactionsByAddress로 사용 가능합니다. 레거시 강화된 거래 주소 엔드포인트와 달리, 요청 매개변수는 쿼리 문자열 매개변수 대신 JSON 본문으로 전송됩니다.

요청 본문

string

필수

거래 기록을 가져올 주소입니다.

number

기본값:"100"

반환할 거래 수입니다. MIN_LIMIT 및 MAX_LIMIT 사이여야 합니다.

string

이 서명 이전의 거래를 반환합니다.

string

이 서명 이후의 거래를 반환합니다.

string

이전 응답에서 반환된 커서입니다.

string

기본값:"desc"

반환된 거래의 정렬 순서입니다.

INLINE_CODE_PLACEHOLDER
INLINE_CODE_PLACEHOLDER

string

기본값:"confirmed"

기록을 가져올 때 사용되는 확인 수준입니다.

INLINE_CODE_PLACEHOLDER
INLINE_CODE_PLACEHOLDER

boolean

기본값:"false"

INCLUDE_RAW_PLACEHOLDER가 TRUE일 때, 각 결과의 RAW_TRANSACTIONS_PLACEHOLDER로 원시 Solana 거래 페이로드를 포함합니다.

object

슬롯 비교 경계입니다. 각 경계는 선택 사항입니다: SLOT_BOUNDS_PLACEHOLDER.

object

Unix 초로 블록 시간 비교 경계입니다. 각 경계는 선택 사항입니다: TIME_BOUNDS_PLACEHOLDER.

페이지 매김

응답의 모양은 다음과 같습니다. 각 ITEM_PLACEHOLDER 항목은 파싱된 거래로 반환된 FORMAT_PLACEHOLDER와 같은 형식을 사용합니다: CODE_PLACEHOLDER 다음 요청에 CURSOR를 전달하여 계속하세요. CURSOR가 없으면, 서비스가 사용 가능한 페이지 범위의 끝에 도달한 것입니다.

시작하기

데이터 스트리밍 및 이벤트 수신

데이터 API 및 RPC

트레이딩

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

파싱된 이벤트 빠른 시작

빠른 시작

가이드

Pump.fun 민트 가져오기

GraphQL로 쿼리하기

향상된 거래에서 마이그레이션

REST 레퍼런스

거래 파싱

요청 본문

참고 사항

파싱된 거래 기록

요청 본문

페이지 매김

​빠른 시작

​가이드

Pump.fun 민트 가져오기

GraphQL로 쿼리하기

향상된 거래에서 마이그레이션

​REST 레퍼런스

​거래 파싱

​요청 본문

​참고 사항

​파싱된 거래 기록

​요청 본문

​페이지 매김

빠른 시작

가이드

REST 레퍼런스

거래 파싱

요청 본문

참고 사항

파싱된 거래 기록

요청 본문

페이지 매김