> ## 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`
返されるトランザクションのソート順。
* INLINE CODE\_PLACEHOLDER\_eb9c68dc9cdbad78\_END
* `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 ja/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: >
強力なフィルタリング、ソート、およびページネーション機能を備えた強化されたトランザクション履歴APIで、任意のSolanaアドレスに関連するトランザクションデータを取得します。この高度なメソッドは以下を提供することで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: 要求ごとのトランザクションの最大数。
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
description: リクエストと一致する識別子。
example: '1'
result:
type: object
description: トランザクションデータとページネーション情報。
properties:
data:
type: array
description: トランザクション情報のリスト。
items:
oneOf:
- type: object
description: >-
署名レベルのトランザクション概要（transactionDetailsが"signatures"の場合）。
properties:
signature:
type: string
description: ベース58エンコードされたトランザクション署名。
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: トランザクションが含まれるブロックを持つスロット。
example: 1054
transactionIndex:
type: integer
description: >-
ブロック内のトランザクションのゼロベースのインデックス。ブロック内のトランザクションの順序を決定するのに役立ちます。
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: >-
ブロック内のトランザクションのゼロベースのインデックス。ブロック内のトランザクションの順序を決定するのに役立ちます。
example: 42
transaction:
type: object
description: >-
選択されたエンコーディングに基づくエンコードまたは解析されたトランザクションオブジェクト。
meta:
type: object
description: トランザクションステータスメタデータ。
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:
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
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)で無料で取得できます。
````