> ## 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.

# ウォレットAPI概説 (ベータ)

> ウォレットAPIを使用してSolanaウォレットデータを照会します。残高、取引履歴、転送、身元情報、資金源を1つのリクエストで取得します。

<Note>
  ウォレットAPIはベータ版です。エンドポイントと応答形式は変更される可能性があります。
</Note>

## ウォレットAPIとは何ですか？

ウォレットAPIは、完全なSolanaウォレットデータを照会するための高レベルなRESTエンドポイントを提供します。残高、取引履歴、トークン転送、身元解決、過去の残高、資金源などです。複数のRPCコールを行い生のブロックチェーンデータを解析する代わりに、構造化された人間が読みやすい情報をUSD価格で1つのリクエストで取得できます。

これは、ウォレット、ポートフォリオトラッカー、エクスプローラー、決済処理業者、税務ツール、コンプライアンスおよびAMLシステム向けに構築されています。すべてのエンドポイントはベースURL `https://api.helius.xyz` を共有し、人間が読みやすい単位で金額を返します（ラマート変換は不要です）。

## ウォレットデータにヒリウスを選ぶ理由

<CardGroup cols={2}>
  <Card title="1回のRESTコール" icon="bolt">
    構造化された残高、履歴、転送が生のRPC応答を結合することなく得られます。
  </Card>

  <Card title="USD価格内蔵" icon="dollar-sign">
    トークン残高には、DASから供給されたUSD値とポートフォリオ合計が含まれます。
  </Card>

  <Card title="身元解決" icon="address-card">
    32,500以上のラベル付きアカウントとプログラムに加え、取引所、プロトコル、機関向けの21.5M以上のカテゴリー別タグ。
  </Card>

  <Card title="人間が読みやすい出力" icon="book-open">
    生のラマートや命令の代わりに、明確で小数調整されたデータ。
  </Card>
</CardGroup>

## 主要エンドポイント

<CardGroup cols={2}>
  <Card title="ウォレット身元" icon="address-card" href="/ja/wallet-api/identity">
    アドレスまたはSNS/ANSドメインで既知のウォレットを識別します—取引所、プロトコル、機関。
  </Card>

  <Card title="ウォレット残高" icon="scale-balanced" href="/ja/wallet-api/balances">
    USD値、ロゴ、メタデータを含むすべてのトークンおよびNFT残高。
  </Card>

  <Card title="過去の残高" icon="clock" href="/ja/wallet-api/balance-at">
    過去のタイムスタンプ、日時、またはスロットでのトークンまたはSOL残高。
  </Card>

  <Card title="ウォレット履歴" icon="clock-rotate-left" href="/ja/wallet-api/history">
    各取引の残高変化を含む完全な取引履歴。
  </Card>

  <Card title="トークン転送" icon="arrow-right-arrow-left" href="/ja/wallet-api/transfers">
    送信者/受信者情報を含むすべての入出金転送。
  </Card>

  <Card title="資金源" icon="money-bill-transfer" href="/ja/wallet-api/funded-by">
    ウォレットの元の資金源、最初の入金SOLまで追跡。
  </Card>
</CardGroup>

## どのエンドポイントを使用すべきか？

| 必要な情報                      | 使用すべきエンドポイント                       | 戻り値                                |
| -------------------------- | ---------------------------------- | ---------------------------------- |
| ウォレットが何であるか（取引所、プロトコル、ラベル） | [身元](/ja/wallet-api/identity)      | 既知のアドレスに対する名前、カテゴリー、およびタグ          |
| ウォレットの現在のポートフォリオ           | [残高](/ja/wallet-api/balances)      | USD値を含むすべてのトークンおよびNFT              |
| 過去のある時点での残高                | [過去の残高](/ja/wallet-api/balance-at) | タイムスタンプ/日時/スロット時点での1つのトークンまたはSOL残高 |
| 完全な取引アクティビティ               | [履歴](/ja/wallet-api/history)       | 各取引での残高変化を解析した取引                   |
| 送受信された転送のみ                 | [転送](/ja/wallet-api/transfers)     | やりとりの相手と方向を含む転送レベルのビュー             |
| ウォレットの資金の出所                | [資金源](/ja/wallet-api/funded-by)    | 最初の入金SOL転送とその送信者                   |

基礎となるルートのクイックリファレンス（ベースURL `https://api.helius.xyz`）：

* `GET /v1/wallet/{wallet}/identity` — アドレスまたはSNS/ANSドメインでウォレットの身元を取得
* `POST /v1/wallet/batch-identity` — バッチ身元検索（最大100のアドレスおよび/またはドメイン）
* `GET /v1/wallet/{wallet}/balances` — すべてのトークンおよびNFT残高を取得
* `GET /v1/wallet/{wallet}/balance-at` — 過去のタイムスタンプ、日時、またはスロットでトークンまたはSOL残高を取得
* `GET /v1/wallet/{wallet}/history` — 残高変化を伴う取引履歴を取得
* `GET /v1/wallet/{wallet}/transfers` — すべてのトークン転送活動を取得
* `GET /v1/wallet/{wallet}/funded-by` — 元の資金源を見つける

## 認証

すべてのウォレットAPIリクエストにはAPIキーが必要です。クエリパラメータまたはヘッダーとして渡すことができます：

<Tabs>
  <Tab title="クエリパラメータ">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="ヘッダー">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## プランの要件

アイデンティティおよび資金源のエンドポイントは、有料プランを必要とします。無料プランでは、これらのエンドポイントへのリクエストは`403 Forbidden`を返します。他のすべてのエンドポイントは、無料プランを含むすべてのプランで利用可能です。

| エンドポイント                              | 無料プラン           |
| ------------------------------------ | --------------- |
| `GET /v1/wallet/{wallet}/identity`   | `403` — 有料プランのみ |
| `POST /v1/wallet/batch-identity`     | `403` — 有料プランのみ |
| `GET /v1/wallet/{wallet}/funded-by`  | `403` — 有料プランのみ |
| `GET /v1/wallet/{wallet}/balances`   | 利用可能            |
| `GET /v1/wallet/{wallet}/balance-at` | 利用可能            |
| `GET /v1/wallet/{wallet}/history`    | 利用可能            |
| `GET /v1/wallet/{wallet}/transfers`  | 利用可能            |

どの有料ティアでも、制限されたエンドポイントが解除されます — Developer、Business、およびそれ以外のすべての上位ティア（たとえばEnterprise）。アイデンティティと資金源の確認を有効にするには、[ダッシュボードでプランをアップグレード](https://dashboard.helius.dev)してください。

## 金額と単位

Wallet APIは、生のSolanaデータの高レベル抽象化です。すべての`amount`フィールドは**人間にとって読みやすい**形式であり、既にトークンの`decimals`で割られているため、変換なしですぐに表示できます。生のSolana RPC呼び出しは、ラメポート（最小単位、10⁻⁹ SOL）で値を返しますが、Wallet APIはそうではありません。`"amount": 1.5`は1.5 SOLを意味し、1.5ラメポートではありません。

正確な算術が必要な場合、一部のエンドポイントは`amountRaw`も公開します。これは、生の整数を文字列としてシリアル化し、浮動小数点の精度損失を避けるためです。変換公式は次の通りです:

`amount = parseInt(amountRaw) / 10**decimals`

| エンドポイント                   | 人間に読みやすい`amount`            | 生の`amountRaw`文字列  |
| ------------------------- | --------------------------- | ----------------- |
| **バランス**                  | `balance`フィールド              | 利用不可              |
| **指定バランス**                | `balance`フィールド（10進数**文字列**） | `balanceRaw`フィールド |
| **出資者**                   | `amount`フィールド               | `amountRaw`フィールド  |
| **送金**                    | `amount`フィールド               | `amountRaw`フィールド  |
| **履歴** (`balanceChanges`) | `amount`フィールド               | 利用不可              |

表示には、`amount`を使用します。オンチェーン命令やその他のシステムで整数演算が必要な場合には、`amountRaw`を使用します。

## はじめに

<Steps>
  <Step title="APIキーを取得">
    [dashboard.helius.dev](https://dashboard.helius.dev)でサインアップしてAPIキーを取得してください。
  </Step>

  <Step title="エンドポイントを選択">
    上記のテーブルを使用して、使用ケースに一致するエンドポイントを選択します。
  </Step>

  <Step title="最初のリクエストを送信">
    シンプルなバランス問合せから始めます:

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="レスポンスを処理">
    JSONレスポンスを解析し、アプリケーションでデータを表示します。
  </Step>
</Steps>

## 次のステップ

<CardGroup cols={3}>
  <Card title="データ取得" icon="database" href="/ja/getting-data">
    HeliusでSolanaデータをクエリするすべての方法を探索します。
  </Card>

  <Card title="APIリファレンス" icon="code" href="/ja/api-reference/wallet-api">
    すべてのWallet APIエンドポイントのリクエストおよびレスポンススキーマ。
  </Card>

  <Card title="サポートに連絡" icon="headset" href="/ja/support/contact-support">
    Discord、チャット、メールを通じてサポートを受け取ります。
  </Card>
</CardGroup>