거래 구문 분석

Enhanced Transactions API는 유지 관리 모드에 있는 이전 제품입니다. 여전히 작동하며 이 페이지는 계속 사용 가능하지만 새로운 파서 유형이나 기능 작업은 받지 않습니다. 후속 제품은 IDL 카탈로그를 통해 명령어를 디코딩하는 Parsed Events이며, 유료 요금제에서 오픈 베타 상태입니다. 마이그레이션 가이드는 이동 단계를 단계별로 안내합니다. 거래 기록 및 백필에는 getTransactionsForAddress를 사용할 수 있으며, 인간이 읽을 수 있는 지갑 데이터를 위해 Wallet API를 사용할 수 있습니다.

개요

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

언제 사용해야 하는가

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

새 빌드의 경우, getTransaction는 원시 거래를 반환하며, getTransactionsForAddress는 최신의 관련 이력 경로입니다.

빠른 시작

API 키 받기

dashboard.helius.dev에서 가입하고 API 키를 복사하세요.

서명을 /v0/transactions로 POST하기

서명 배열을 transactions 본문 필드에 전달하십시오.

JavaScript
Python

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();

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()

구문 분석된 응답 읽기

각 거래는 설명, 유형, 전송 및 이벤트 요약과 함께 반환됩니다. 아래 응답을 참조하세요.

요청 매개변수

string[]

필수

구문 분석할 거래 서명의 배열. 요청당 최대 100개의 서명.

응답

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

{
  "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 참조를 참조하세요.

다음 단계

거래 이력

필터링 및 페이지 매김을 통해 주소의 사람이 읽을 수 있는 거래 이력을 가져오세요.

getTransactionsForAddress

거래 이력 및 백필을 위한 최신 Helius 네이티브 대체품입니다.

지갑 API

사람이 읽을 수 있는 지갑 데이터를 위한 REST 엔드포인트: 잔액, 이력, 전송.

데이터 얻기 개요

Solana 데이터를 조회하기 위한 모든 Helius 옵션을 비교하십시오.

시작하기

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

데이터 API 및 RPC

트레이딩

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

개요

언제 사용해야 하는가

빠른 시작

요청 매개변수

응답

다음 단계

거래 이력

getTransactionsForAddress

지갑 API

데이터 얻기 개요

​개요

​언제 사용해야 하는가

​빠른 시작

​요청 매개변수

​응답

​다음 단계

거래 이력

getTransactionsForAddress

지갑 API

데이터 얻기 개요

개요

언제 사용해야 하는가

빠른 시작

요청 매개변수

응답

다음 단계