> ## 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.
# getTransactionsForAddress
> 강력한 필터링, 정렬, 페이지 매김 기능을 갖춘 향상된 거래 내역 API로, 모든 주소에 대한 포괄적인 거래 데이터를 검색할 수 있습니다. 양방향 정렬, 시간/슬롯/상태 필터링 및 효율적인 키셋 페이지 매김을 지원합니다.
## 요청 매개변수
거래 내역을 검색할 Solana 계정 주소 (지갑, 토큰, 프로그램, NFT 등).
반환할 거래 세부 정보 수준.
* `signatures`
* `full`
반환되는 거래의 정렬 순서.
* `asc`
* `desc`
요청에 대한 커밋 수준. `processed` 커밋은 지원되지 않습니다.
* `confirmed`
* `finalized`
요청에 사용할 최소 컨텍스트 슬롯 (선택 사항).
요청당 최대 거래 수. transactionDetails:"signatures"의 경우 1–1000, transactionDetails:"full"의 경우 1–1000을 사용합니다.
이전 응답에서 다음 페이지 결과를 가져오려면 페이지 매김 토큰을 사용합니다 (형식 "slot:position").
거래 데이터의 인코딩 형식 (transactionDetails=full인 경우에만 적용됨).
* `json`
* `jsonParsed`
* `base58`
* `base64`
반환할 최대 거래 버전 (transactionDetails=full인 경우에만 적용됨).
거래 결과를 좁히기 위한 고급 필터입니다.
슬롯 번호로 필터링합니다.
슬롯 번호 이상.
슬롯 번호 초과.
슬롯 번호 이하.
슬롯 번호 미만.
블록 타임스탬프로 필터링합니다 (Unix 타임스탬프).
타임스탬프 이상.
타임스탬프 초과.
타임스탬프 이하.
타임스탬프 미만.
타임스탬프와 동일.
거래 서명으로 필터링합니다.
이 값 이상인 서명이 있는 거래를 가져옵니다.
이 서명 이후의 거래를 가져옵니다.
이 값 이하인 서명이 있는 거래를 가져옵니다.
이 서명 이전의 거래를 가져옵니다.
거래 상태로 필터링합니다.
* `succeeded`
* `failed`
* `any`
관련 토큰 계정에 대한 거래를 필터링합니다. 주소가 소유한 토큰 계정과 관련된 거래를 포함할지 여부를 조정합니다.
* `none`
* `balanceChanged`
* `all`
특정 기준에 부합하는 토큰 전송에 주소가 참여한 거래로 결과를 좁힙니다. 모든 필드는 선택 사항이며 AND 조건으로 결합됩니다.
상대방 주소. 다른 쪽이 이 주소인 전송을 매칭합니다.
조회된 주소에 대한 전송 방향.
* `in`
* `out`
* `any`
필터링할 토큰 민트.
체인상의 원시 금액 범위 필터. 모든 필드는 선택 사항이며 결합 가능합니다.
## OpenAPI
````yaml ko/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
강력한 필터링, 정렬 및 페이지 매김 기능을 갖춘 고급 Solana 거래 기록 API로, 모든 주소에 대한 포괄적인 거래 데이터를 검색할
수 있습니다.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: 메인넷 RPC 엔드포인트
- url: https://devnet.helius-rpc.com
description: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
모든 Solana 주소와 관련된 거래 데이터를 검색하기 위한 강력한 필터링, 정렬 및 페이지 매김 기능을 제공하는 향상된 거래
기록 API입니다. 이 고급 메서드는 다음을 제공하여 getSignaturesForAddress의 제한을 극복합니다.
- 양방향 정렬 (오름차순/내림차순 시간 순서)
- 슬롯, 시간, 서명 및 거래 상태에 따른 고급 필터링
- 토큰 계정 지원 (연관된 토큰 계정의 거래 포함)
- 상대방, 방향, 발행 및 원시 금액에 따른 토큰 전송 필터링
- 슬롯 기반 키를 사용한 효율적인 키셋 페이지 매김
- 전체 거래 세부 정보 또는 서명만 반환하는 옵션
- 기간 범위 쿼리 및 상태 필터링 지원
포괄적인 지갑 기록, 분석 대시보드, 감사 추적 및 데이터 검색에 대한 세밀한 제어가 필요한 모든 애플리케이션을 구축하는 데
적합합니다.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: JSON-RPC 프로토콜 버전.
default: '2.0'
id:
type: string
example: '1'
description: 요청에 대한 고유 식별자.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: 호출할 RPC 메서드 이름.
default: getTransactionsForAddress
params:
type: array
description: 필요한 계정 주소 및 선택적 구성 개체를 포함하는 배열입니다.
minItems: 1
maxItems: 2
prefixItems:
- type: string
description: 트랜잭션 기록을 검색할 Solana 계정 주소 (지갑, 토큰, 프로그램, NFT 등).
example: Vote111111111111111111111111111111111111111
- type: object
description: 필터링, 정렬 및 페이지 매김을 위한 고급 쿼리 구성.
properties:
transactionDetails:
type: string
description: 반환할 거래의 세부 수준.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: 반환된 거래의 정렬 순서.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: 요청에 대한 커밋 수준. `processed` 커밋은 지원되지 않습니다.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: 요청에 사용할 최소 컨텍스트 슬롯 (선택 사항).
example: 1000
limit:
type: integer
description: >-
요청당 최대 트랜잭션 수. transactionDetails:"signatures"에 대해
1–1000을 사용하고 transactionDetails:"full"에 대해 1–1000을
사용합니다.
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
이전 응답에서 얻은 페이지 매김 토큰으로 결과의 다음 페이지를 가져옵니다 (형식
"slot:position").
example: '1053:13'
encoding:
type: string
description: 거래 데이터의 인코딩 형식 (transactionDetails=full일 때만 적용).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: 반환할 최대 거래 버전 (transactionDetails=full일 때만 적용).
example: 0
filters:
type: object
description: 거래 결과를 좁히기 위한 고급 필터.
properties:
slot:
type: object
description: 슬롯 번호로 필터링.
properties:
gte:
type: integer
description: 슬롯 번호보다 크거나 같은 경우.
example: 100
gt:
type: integer
description: 슬롯 번호보다 큰 경우.
example: 100
lte:
type: integer
description: 슬롯 번호보다 작거나 같은 경우.
example: 200
lt:
type: integer
description: 슬롯 번호보다 작은 경우.
example: 200
additionalProperties: false
blockTime:
type: object
description: 블록 타임스탬프 (Unix 타임스탬프)로 필터링.
properties:
gte:
type: integer
description: 타임스탬프보다 크거나 같은 경우.
example: 1640995200
gt:
type: integer
description: 타임스탬프보다 큰 경우.
example: 1640995200
lte:
type: integer
description: 타임스탬프보다 작거나 같은 경우.
example: 1641081600
lt:
type: integer
description: 타임스탬프보다 작은 경우.
example: 1641081600
eq:
type: integer
description: 타임스탬프와 같은 경우.
example: 1641038400
additionalProperties: false
signature:
type: object
description: 트랜잭션 서명으로 필터링.
properties:
gte:
type: string
description: 이 값보다 크거나 같은 서명을 가진 거래를 가져옵니다.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: 이 서명 이후의 거래를 가져옵니다.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: 이 값보다 작거나 같은 서명을 가진 거래를 가져옵니다.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: 이 서명 이전의 거래를 가져옵니다.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: 트랜잭션 상태로 필터링.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
관련된 토큰 계정의 트랜잭션을 필터링합니다. 주소가 소유한 토큰 계정과 관련된 거래를
포함할지 여부를 제어합니다.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
쿼리한 주소가 상대방, 방향, 발행 또는 원시 금액 범위에 일치하는 토큰 전송에 참여한
거래로 필터링합니다.
additionalProperties: false
items: false
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
responses:
'200':
description: 지정된 주소에 대한 거래를 성공적으로 검색했습니다.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전.
enum:
- '2.0'
example: '2.0'
id:
type: string
example: '1'
description: 요청과 일치하는 식별자.
result:
type: object
description: 거래 데이터 및 페이지 매김 정보.
properties:
data:
type: array
description: 트랜잭션 정보 목록.
items:
oneOf:
- type: object
description: >-
서명 수준 거래 요약 (transactionDetails가 "signatures"일
때).
properties:
signature:
type: string
description: Base-58로 인코딩된 서명.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: 거래가 포함된 블록의 슬롯.
example: 1054
transactionIndex:
type: integer
description: >-
블록 내 거래의 0부터 시작하는 인덱스. 블록 내 거래 순서를 결정하는 데
유용합니다.
example: 42
err:
oneOf:
- type: object
description: 거래 실패 시 오류
- type: 'null'
description: 거래 실패 시 오류, 성공 시 null.
example: null
memo:
oneOf:
- type: string
description: 거래와 관련된 메모
- type: 'null'
description: 거래와 관련된 메모, 없으면 null.
example: null
blockTime:
oneOf:
- type: integer
description: Unix 타임스탬프로 예상된 생산 시간
- type: 'null'
description: Unix 타임스탬프로 예상된 생산 시간(에포크 이후 초), 없으면 null.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: 거래의 클러스터 확인 상태
- type: 'null'
description: 거래의 클러스터 확인 상태.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
상태 메타데이터가 포함된 전체 거래 (transactionDetails가 "full"일
때).
properties:
slot:
type: integer
description: 거래가 포함된 블록의 슬롯.
example: 1054
transactionIndex:
type: integer
description: >-
블록 내 거래의 0부터 시작하는 인덱스. 블록 내 거래 순서를 결정하는 데
유용합니다.
example: 42
transaction:
type: object
description: 선택한 인코딩에 따른 인코딩 또는 구문 분석된 거래 개체.
meta:
type: object
description: >-
거래 상태 메타데이터 — err, fee,
preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages 및
computeUnitsConsumed를 포함하여 getTransaction과
동일한 형태.
blockTime:
oneOf:
- type: integer
description: Unix 타임스탬프로 예상된 생산 시간
- type: 'null'
description: Unix 타임스탬프로 예상된 생산 시간(에포크 이후 초), 없으면 null.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: 다음 결과 페이지를 검색하기 위한 토큰
- type: 'null'
description: 다음 페이지에 대한 페이지 매김 토큰, 더 이상 결과가 없으면 null.
example: '1055:5'
examples:
signaturesResponse:
summary: 서명 세부 정보만 있는 응답
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: 전체 거래 세부 정보가 포함된 응답
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
err: null
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
preTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '1500000'
decimals: 6
uiAmount: 1.5
uiAmountString: '1.5'
postTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '500000'
decimals: 6
uiAmount: 0.5
uiAmountString: '0.5'
logMessages:
- ...
computeUnitsConsumed: 2100
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: 잘못된 요청 - 잘못된 요청 매개변수 또는 잘못된 형식의 요청.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: 잘못된 매개변수
id: '1'
'401':
description: 인증되지 않음 - 잘못되었거나 누락된 API 키.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: 인증되지 않음
id: '1'
'429':
description: 요청이 너무 많음 - 속도 제한을 초과했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: 요청이 너무 많음
id: '1'
'500':
description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: 내부 오류
id: '1'
'503':
description: 서비스 이용 불가 - 서비스가 일시적으로 이용할 수 없습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: 서비스 이용 불가
id: '1'
'504':
description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: 게이트웨이 시간 초과
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: 오류 코드입니다.
example: -32602
message:
type: string
description: 오류 메시지입니다.
data:
type: object
description: 오류에 대한 추가 데이터입니다.
id:
type: string
description: 요청과 일치하는 식별자입니다.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
귀하의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
받을 수 있습니다.
````