> ## 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. # getTransfersByAddress > アドレスごとにパース済みで人間が読みやすい形式のトークンおよびネイティブSOL転送オブジェクトを、ミント、時間、金額、相手先、ページネーションでフィルタリングしてクエリします。 ## 概要 `getTransfersByAddress` は、ウォレットアドレスを含むトークンおよびネイティブSOLの動きに関する、パース済みで人間が読みやすい転送オブジェクトを返します。ミント、ブロック時間、金額、スロット、方向、または相手先でフィルタリングして結果を絞り込みます。この応答は、ウォレットのアクティビティビュー、支払い追跡、残高調整を正確に行うために設計されています。 ミントおよびバーン転送は一方的です。ミントには `fromUserAccount: null` があり、受取人へのインバウンド転送としてのみ返されます。バーンには `toUserAccount: null` があり、バーニングオーナーへのアウトバウンド転送としてのみ返されます。 ## リクエストパラメータ ベース58でエンコードされた所有者ウォレットアドレスをクエリして転送を検索します。関連トークンアカウント（ATA）ではなく、ウォレット所有者のアドレスを渡します。 相手先アドレスでフィルタリングします。このアドレスへの転送またはこのアドレスからの転送のみを返します。 クエリされたアドレスに対する転送方向でフィルタリングします。 * `in` * `out` * `any` トークンミントアドレス。ネイティブSOLにはSo11111111111111111111111111111111111111111を、WSOLにはSo11111111111111111111111111111111111111112を使用します。 SOL/WSOL表示モード。mergedは、WSOLをネイティブSOLとして扱ってラップ/アンラップ行を除外し、SOL単位の履歴を簡単に調整できるようにします。separateは、WSOLを独立したSPLトークンミントとして保持し、ラップ/アンラップ行を含めます。 * `merged` * `separate` 金額、ブロック時間、スロットに対する追加フィルタ。 範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。 より大きい。 以上。 より小さい。 以下。 範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。 より大きい。 以上。 より小さい。 以下。 範囲比較フィルタ。すべてのフィールドはオプションで、組み合わせることができます。 より大きい。 以上。 より小さい。 以下。 返す転送の最大数。範囲は1から100です。 ページネーションのための前回の応答からのカーソル。 データのコミットメントレベル。 * `finalized` * `confirmed` リクエストに使用する最小のコンテキストスロット（オプション）。 結果の順序付け。 * `asc` * `desc` ## OpenAPI ````yaml ja/openapi/rpc-http/getTransfersByAddress.yaml POST / openapi: 3.1.0 info: title: Solana RPC API version: 1.0.0 description: >- アドレスをもとに、ミント、時間、金額、相手先でフィルタリングして解析された人間が読みやすいトークンやネイティブSOL転送オブジェクトをクエリするための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: デブネットRPCエンドポイント security: [] paths: /: post: tags: - RPC summary: getTransfersByAddress description: > ウォレットアドレスに対する解析された人間が読みやすいトークンおよびネイティブSOL転送オブジェクトを返します。このHelius RPCメソッドは、完全なトランザクションペイロードの代わりに簡潔な転送専用レコードを返し、正確なウォレット活動のビュー、支払い追跡、および残高調整のために設計されています。 ミント、ブロック時間、金額、スロット、方向、および相手先で転送履歴をフィルタリングできます。 operationId: getTransfersByAddress 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: - getTransfersByAddress example: getTransfersByAddress description: 呼び出すRPCメソッドの名前。 default: getTransfersByAddress params: type: array description: 必要なウォレットアドレスとオプションの設定オブジェクトを含む配列。 default: - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY minItems: 1 maxItems: 2 prefixItems: - type: string description: >- 転送をクエリするためのBase58でエンコードされたオーナーウォレットアドレス。関連トークンアカウント(ATA)ではなく、ウォレット所有者のアドレスを渡してください。 example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY - type: object description: オプションの転送クエリ設定。 properties: with: type: string description: 相手先アドレスでフィルタリングします。このアドレスへの転送またはこのアドレスからの転送のみを返します。 example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx direction: type: string description: クエリされたアドレスに対する転送方向でフィルタリングします。 enum: - in - out - any default: any example: in mint: type: string description: >- トークンのミントアドレス。ネイティブSOLにはSo11111111111111111111111111111111111111111を、WSOLにはSo11111111111111111111111111111111111111112を使用します。 example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v solMode: type: string description: >- SOL/WSOL表示モード。mergedはWSOLをネイティブSOLとして扱い、履歴を調整しやすくするためにwrap/unwrap行を除外します。separateはWSOLを個別のSPLトークンミントとして保持し、wrap/unwrap行を含みます。 enum: - merged - separate default: merged example: merged filters: type: object description: 金額、ブロック時間、およびスロットの追加フィルター。 properties: amount: $ref: '#/components/schemas/TransferComparisonFilter' description: UI金額ではなく、生の転送金額でフィルタリングします。 blockTime: $ref: '#/components/schemas/TransferComparisonFilter' description: Unix秒でのブロックタイムスタンプでフィルタリングします。 slot: $ref: '#/components/schemas/TransferComparisonFilter' description: スロット番号でフィルタリングします。 additionalProperties: false limit: type: integer description: 返す最大転送数。範囲は1から100まで。 minimum: 1 maximum: 100 default: 100 example: 50 paginationToken: type: string description: ページネーションのために前の応答からのカーソル。 example: 315069220:308:2:1:splTransfer commitment: type: string description: データの確約レベル。 enum: - finalized - confirmed default: finalized example: finalized minContextSlot: type: integer description: リクエストに使用する最小コンテキストスロット（オプション）。 example: 1000 sortOrder: type: string description: 結果の順序。 enum: - asc - desc default: desc example: desc additionalProperties: false items: false example: - 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY - mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v limit: 50 sortOrder: desc 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: $ref: '#/components/schemas/TokenTransfer' paginationToken: oneOf: - type: string description: 次のページの結果を取得するためのカーソル。 - type: 'null' description: 次のページのカーソル、もしくはこれ以上結果がない場合はnull。 example: 315073428:35:1:0:splTransfer examples: transferResponse: summary: 転送応答 value: jsonrpc: '2.0' id: '1' result: data: - signature: >- 5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG slot: 315073428 blockTime: 1736159420 type: transfer fromUserAccount: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx toUserAccount: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY fromTokenAccount: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x toTokenAccount: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v amount: '2500000' decimals: 6 uiAmount: '2.5' confirmationStatus: finalized transactionIdx: 35 instructionIdx: 1 innerInstructionIdx: 0 paginationToken: 315073428:35:1:0:splTransfer '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: TokenTransfer: type: object properties: signature: type: string description: Base58でエンコードされたトランザクションの署名。 example: >- 5GEX7Q3X5Q8yJGbKYoR7mtzQmG8tpoEwzjPgqVmn3y5xg3yKwqXcDdN5YVcc9V6vA4TuH5iM6FHRVhTxvz4AX2zG slot: type: integer description: トランザクションを含むスロット番号。 example: 315073428 blockTime: type: integer description: ブロックのUnixタイムスタンプ（秒）。 example: 1736159420 type: type: string description: 解析された転送タイプ。 enum: - transfer - mint - burn - wrap - unwrap - changeOwner - withdrawWithheldFee example: transfer fromUserAccount: oneOf: - type: string - type: 'null' description: トークンを送信したウォレットアドレス、または送信者が存在しない場合はnull。このフィールドは常に存在します。 example: 7hPhaUpydpvm8wtiS3k4LPZKUmivQRs7YQmpE1hFshHx toUserAccount: oneOf: - type: string - type: 'null' description: トークンを受け取ったウォレットアドレス、または受取人が存在しない場合はnull。このフィールドは常に存在します。 example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY fromTokenAccount: type: string description: ソーストークンアカウント。ネイティブSOL転送の場合は省略されます。 example: HcvK3EJ74iM9g11cUgsaPvLSrhCvCwcrWxBNd87LsC1x toTokenAccount: type: string description: 宛先トークンアカウント。ネイティブSOL転送の場合は省略されます。 example: CBcYniR9G9CN3zGMnwNE4SWbqkYWvCFVreEob9xHnQCY mint: type: string description: >- トークンのミントアドレス。ネイティブSOLはSo11111111111111111111111111111111111111111、WSOLはsolModeがseparateの場合So11111111111111111111111111111111111111112を使用します。 example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v amount: type: string description: 精度を保つために文字列としての生の転送量。手数料を伴うToken-2022転送の場合、これは目的地が受け取る金額です。 example: '2500000' feeAmount: type: string description: >- Token-2022転送手数料拡張により控除された転送手数料。手数料を伴う転送のみで表示されます。手数料を伴う転送の場合、ソースは控除額とfeeAmountを合わせた金額が引かれ、目的地には金額が加算されます。 example: '13450000' decimals: type: integer description: トークンの小数点。ネイティブSOLは9を使用します。 example: 6 uiAmount: type: string description: 人間が読みやすい金額。 example: '2.5' feeUiAmount: type: string description: 人間が読みやすい手数料金額。feeAmountが存在する場合のみ表示されます。 example: '134.5' confirmationStatus: type: string description: 確認ステータス。 enum: - finalized - confirmed example: finalized transactionIdx: type: integer description: ブロック内のトランザクションのインデックス。 example: 35 instructionIdx: type: integer description: トランザクション内の命令のインデックス。 example: 1 innerInstructionIdx: type: integer description: 内側の命令内のインデックス。転送がトップレベルの場合はゼロ。 example: 0 required: - signature - slot - blockTime - type - fromUserAccount - toUserAccount - mint - amount - decimals - uiAmount - confirmationStatus - transactionIdx - instructionIdx - innerInstructionIdx additionalProperties: false 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)で無料で取得可能です。 ````