파싱된 이벤트 빠른 시작

Parsed Events를 처음 사용하시나요? 먼저 Parsed Streams의 멘탈 모델을 읽어보세요. Parsed Events는 REST를 통해 동일하게 디코딩된 명령을 반환합니다.

빠른 시작

Get Access

Parsed Events는 모든 플랜에서 사용할 수 있으며 요청당 10크레딧이 부과됩니다. 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",
      ],
      rawTransaction: "none",
    }),
  });

  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"
    ],
    "rawTransaction": "none"
  }'

결과 읽기

응답은 요청한 서명당 하나의 결과를 포함하며, 입력 순서를 따릅니다. 각 결과에는 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가 없으면, 서비스가 사용 가능한 페이지 범위의 끝에 도달한 것입니다.

가이드

Fetch Pump.fun Mints

지갑이 Pump.fun에 배포한 모든 토큰을 페이지 단위로 조회합니다.

Migrate from Enhanced Transactions

기존 API의 엔드포인트, 매개변수 및 응답 매핑을 확인합니다.

REST 레퍼런스

두 REST 메서드 모두 https://mainnet.helius-rpc.com의 /v1/parsed-events/에서 POST를 통해 JSON 본문을 받으며, api-key 쿼리 매개변수로 인증합니다. 요청 본문에 알 수 없는 필드가 있으면 거부하므로, 오타를 조용히 무시하지 않고 명확한 오류를 반환합니다.

거래 파싱

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

요청 본문

string[]

필수

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

string

기본값:"confirmed"

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

INLINE_CODE_PLACEHOLDER
INLINE_CODE_PLACEHOLDER

string

기본값:"none"

각 결과에서 getTransaction 구조의 rawTransaction로 반환되는 원시 Solana 트랜잭션의 인코딩입니다.

none
json
jsonParsed
base64

참고 사항

processed 커미트먼트는 지원되지 않습니다.
요청의 rawTransaction 필드를 json, jsonParsed 또는 base64로 설정하지 않으면 rawTransaction가 생략됩니다. 이전 includeRawTransaction: true도 여전히 json의 별칭으로 작동합니다.
트랜잭션 실행이 실패해도 파싱할 수 있습니다. 이 경우 parsed.transactionStatus는 ERROR이며, 트랜잭션 오류가 있으면 parsed.error에 표시됩니다.
요청 수준의 검증 오류가 발생하면 항목 수준의 결과 대신 오류 응답을 반환합니다.

파싱된 트랜잭션 내역

POST /v1/parsed-events/transaction-history는 주소의 파싱된 트랜잭션 내역을 반환합니다. 페이지네이션, 서명 범위, 슬롯 범위, 블록 시간 범위, 정렬 순서 및 선택적 원시 트랜잭션을 지원합니다. 기존 Enhanced Transactions 주소 엔드포인트와 달리 요청 매개변수는 쿼리 문자열 매개변수가 아닌 JSON 본문으로 전송됩니다.

요청 본문

string

필수

트랜잭션 내역을 가져올 주소입니다.

number

기본값:"100"

반환할 트랜잭션 수입니다. 1에서 100 사이여야 합니다.

string

이 서명 이전의 트랜잭션을 반환합니다.

string

이 서명 이후의 트랜잭션을 반환합니다.

string

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

string

기본값:"desc"

반환되는 트랜잭션의 정렬 순서입니다.

asc
desc

string

기본값:"confirmed"

내역을 가져올 때 사용하는 커미트먼트 수준입니다.

confirmed
finalized

string

기본값:"succeeded"

포함할 실행 결과입니다.

succeeded
failed
any

string

기본값:"none"

address 자체가 아니라 address가 소유한 토큰 계정만 참조하는 트랜잭션을 포함할지 여부입니다. 수신 토큰 전송은 대부분 수신자의 토큰 계정만 변경합니다.

none
balanceChanged
all

string

기본값:"none"

각 결과에서 getTransaction 구조의 rawTransaction로 반환되는 원시 Solana 트랜잭션의 인코딩입니다.

none
json
jsonParsed
base64

object

슬롯 비교 범위입니다. 각 범위는 선택 사항입니다: gt, gte, lt, lte.

object

Unix 초 단위의 블록 시간 비교 범위입니다. 각 범위는 선택 사항입니다: gt, gte, lt, lte.

페이지네이션

응답은 다음과 같은 구조입니다. 각 data 항목은 Parse Transactions에서 반환되는 것과 동일한 TransactionResult 형식을 사용합니다:

{
  "data": [
    {
      "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      "parserStatus": "OK",
      "parsed": {
        "slot": 433950192,
        "blockTime": 1784487060,
        "fee": 2005000,
        "feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
        "transactionStatus": "OK",
        "nativeTransfers": [],
        "tokenTransfers": [],
        "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": []
      }
    }
  ],
  "paginationToken": "433950192:0"
}

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

시작하기

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

데이터 API 및 RPC

거래

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

파싱된 이벤트 빠른 시작

빠른 시작

가이드

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

REST 레퍼런스

거래 파싱

요청 본문

참고 사항

파싱된 트랜잭션 내역

요청 본문

페이지네이션

​빠른 시작

​가이드

Fetch Pump.fun Mints

Migrate from Enhanced Transactions

​REST 레퍼런스

​거래 파싱

​요청 본문

​참고 사항

​파싱된 트랜잭션 내역

​요청 본문

​페이지네이션

빠른 시작

가이드

REST 레퍼런스

거래 파싱

요청 본문

참고 사항

파싱된 트랜잭션 내역

요청 본문

페이지네이션