メインコンテンツへスキップ
POST
getTransfersByAddress

概要

getTransfersByAddress は、ウォレットアドレスを含むトークンおよびネイティブSOLの動きに関する、パース済みで人間が読みやすい転送オブジェクトを返します。ミント、ブロック時間、金額、スロット、方向、または相手先でフィルタリングして結果を絞り込みます。この応答は、ウォレットのアクティビティビュー、支払い追跡、残高調整を正確に行うために設計されています。
ミントおよびバーン転送は一方的です。ミントには fromUserAccount: null があり、受取人へのインバウンド転送としてのみ返されます。バーンには toUserAccount: null があり、バーニングオーナーへのアウトバウンド転送としてのみ返されます。

リクエストパラメータ

address
string
必須
ベース58でエンコードされた所有者ウォレットアドレスをクエリして転送を検索します。関連トークンアカウント(ATA)ではなく、ウォレット所有者のアドレスを渡します。
with
string
相手先アドレスでフィルタリングします。このアドレスへの転送またはこのアドレスからの転送のみを返します。
direction
string
デフォルト:"any"
クエリされたアドレスに対する転送方向でフィルタリングします。
  • in
  • out
  • any
mint
string
トークンミントアドレス。ネイティブSOLにはSo11111111111111111111111111111111111111111を、WSOLにはSo11111111111111111111111111111111111111112を使用します。
solMode
string
デフォルト:"merged"
SOL/WSOL表示モード。mergedは、WSOLをネイティブSOLとして扱ってラップ/アンラップ行を除外し、SOL単位の履歴を簡単に調整できるようにします。separateは、WSOLを独立したSPLトークンミントとして保持し、ラップ/アンラップ行を含めます。
  • merged
  • separate
filters
object
金額、ブロック時間、スロットに対する追加フィルタ。
filters.amount
object
範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。
filters.amount.gt
number
より大きい。
filters.amount.gte
number
以上。
filters.amount.lt
number
より小さい。
filters.amount.lte
number
以下。
filters.blockTime
object
範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。
filters.blockTime.gt
number
より大きい。
filters.blockTime.gte
number
以上。
filters.blockTime.lt
number
より小さい。
filters.blockTime.lte
number
以下。
filters.slot
object
範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。
filters.slot.gt
number
より大きい。
filters.slot.gte
number
以上。
filters.slot.lt
number
より小さい。
filters.slot.lte
number
以下。
limit
number
デフォルト:"100"
返す転送の最大数。範囲は1から100です。
paginationToken
string
ページネーションのための前回の応答からのカーソル。
example
any
commitment
string
デフォルト:"finalized"
データのコミットメントレベル。
  • finalized
  • confirmed
minContextSlot
number
リクエストに使用する最小のコンテキストスロット(オプション)。
sortOrder
string
デフォルト:"desc"
結果の順序付け。
  • asc
  • desc

承認

api-key
string
query
必須

Helius APIキーを取得してください。ダッシュボードで無料で取得可能です。

ボディ

application/json
jsonrpc
enum<string>
デフォルト:2.0
必須

JSON-RPCプロトコルバージョン。

利用可能なオプション:
2.0
:

"2.0"

id
string
デフォルト:1
必須

リクエストの一意の識別子。

:

"1"

method
enum<string>
デフォルト:getTransfersByAddress
必須

呼び出すRPCメソッドの名前。

利用可能なオプション:
getTransfersByAddress
:

"getTransfersByAddress"

params
tuple
必須

必要なウォレットアドレスとオプションの設定オブジェクトを含む配列。

:

レスポンス

指定されたアドレスに対する転送を正常に取得しました。

jsonrpc
enum<string>

JSON-RPCプロトコルバージョン。

利用可能なオプション:
2.0
:

"2.0"

id
string

リクエストに一致する識別子。

:

"1"

result
object

転送データとページネーション情報。