GraphQL로 쿼리하기

개요

GraphQL 인터페이스는 Parsed Events 메서드 두 가지를 노출합니다: transactions를 통한 Parse Transactions와 transactionsByAddress를 통한 Parsed Transaction History입니다. GraphQL 작업을 POST /v1/parsed-events/graphql으로 보냅니다. REST 엔드포인트와 동일한 파싱된 트랜잭션 모델을 반환하면서 클라이언트가 필요한 필드만 선택할 수 있게 합니다. 필드가 선택된 경우에만 GraphQL은 rawTransaction를 포함합니다. 동적 파서 페이로드는 디코딩된 지시 args, 트랜잭션 실행 error, 요약 parsedData 및 rawTransaction을 포함하여 JSON 스칼라로 유지됩니다.

엔드포인트

GraphQL 작업을 POST /v1/parsed-events/graphql으로 보냅니다. api-key 쿼리 매개변수로 인증합니다.

JavaScript
cURL

const url = "https://mainnet.helius-rpc.com/v1/parsed-events/graphql?api-key=YOUR_API_KEY";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: `query ParseTransactions($signatures: [String!]!) {
      transactions(signatures: $signatures, commitment: CONFIRMED) {
        signature
        parserStatus
      }
    }`,
    variables: {
      signatures: [
        "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      ],
    },
  }),
});

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

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/graphql?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "query": "query ParseTransactions($signatures: [String!]!) { transactions(signatures: $signatures, commitment: CONFIRMED) { signature parserStatus } }",
    "variables": {
      "signatures": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]
    }
  }'

트랜잭션 파싱

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 {
        instructionIndex
        innerInstructionIndex
        programId
        programName
        instructionName
        summary {
          type
          description
          parsedData
        }
        decoded {
          args
          accounts {
            name
            pubkey
            isSigner
            isWritable
          }
        }
      }
    }
    parserError {
      code
      message
    }
  }
}

변수:

{
  "signatures": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]
}

파싱된 트랜잭션 기록

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
  }
}

변수:

{
  "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를 선택합니다:

query ParseWithRaw($signatures: [String!]!) {
  transactions(signatures: $signatures) {
    signature
    rawTransaction
    parsed {
      slot
    }
  }
}

rawTransaction가 선택되지 않으면, 서비스는 응답에 이를 포함하지 않습니다.

여기서 시작하기

실시간 데이터

저지연 트레이딩

과거 데이터 및 지갑 데이터

RPC 메서드 가이드

프로덕션 준비

Orb 사용하기

기타 사용 가이드

GraphQL로 쿼리하기

개요

엔드포인트

트랜잭션 파싱

파싱된 트랜잭션 기록

쿼리 인수

`transactions`

`transactionsByAddress`

원시 트랜잭션

​개요

​엔드포인트

​트랜잭션 파싱

​파싱된 트랜잭션 기록

​쿼리 인수

​transactions

​transactionsByAddress

​원시 트랜잭션

개요

엔드포인트

트랜잭션 파싱

파싱된 트랜잭션 기록

쿼리 인수

`transactions`

`transactionsByAddress`

원시 트랜잭션