メインコンテンツへスキップ
ウォレットAPIはベータ版です。エンドポイントと応答形式は変更される可能性があります。

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

ウォレットAPIは、完全なSolanaウォレットデータを照会するための高レベルなRESTエンドポイントを提供します。残高、取引履歴、トークン転送、身元解決、過去の残高、資金源などです。複数のRPCコールを行い生のブロックチェーンデータを解析する代わりに、構造化された人間が読みやすい情報をUSD価格で1つのリクエストで取得できます。 これは、ウォレット、ポートフォリオトラッカー、エクスプローラー、決済処理業者、税務ツール、コンプライアンスおよびAMLシステム向けに構築されています。すべてのエンドポイントはベースURL https://api.helius.xyz を共有し、人間が読みやすい単位で金額を返します(ラマート変換は不要です)。

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

1回のRESTコール

構造化された残高、履歴、転送が生のRPC応答を結合することなく得られます。

USD価格内蔵

トークン残高には、DASから供給されたUSD値とポートフォリオ合計が含まれます。

身元解決

32,500以上のラベル付きアカウントとプログラムに加え、取引所、プロトコル、機関向けの21.5M以上のカテゴリー別タグ。

人間が読みやすい出力

生のラマートや命令の代わりに、明確で小数調整されたデータ。

主要エンドポイント

ウォレット身元

アドレスまたはSNS/ANSドメインで既知のウォレットを識別します—取引所、プロトコル、機関。

ウォレット残高

USD値、ロゴ、メタデータを含むすべてのトークンおよびNFT残高。

過去の残高

過去のタイムスタンプ、日時、またはスロットでのトークンまたはSOL残高。

ウォレット履歴

各取引の残高変化を含む完全な取引履歴。

トークン転送

送信者/受信者情報を含むすべての入出金転送。

資金源

ウォレットの元の資金源、最初の入金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キーが必要です。クエリパラメータまたはヘッダーとして渡すことができます:

プランの要件

アイデンティティおよび資金源のエンドポイントは、有料プランを必要とします。無料プランでは、これらのエンドポイントへのリクエストは403 Forbiddenを返します。他のすべてのエンドポイントは、無料プランを含むすべてのプランで利用可能です。 どの有料ティアでも、制限されたエンドポイントが解除されます — Developer、Business、およびそれ以外のすべての上位ティア(たとえばEnterprise)。アイデンティティと資金源の確認を有効にするには、ダッシュボードでプランをアップグレードしてください。

金額と単位

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を使用します。

はじめに

1

APIキーを取得

dashboard.helius.devでサインアップしてAPIキーを取得してください。
2

エンドポイントを選択

上記のテーブルを使用して、使用ケースに一致するエンドポイントを選択します。
3

最初のリクエストを送信

シンプルなバランス問合せから始めます:
4

レスポンスを処理

JSONレスポンスを解析し、アプリケーションでデータを表示します。

次のステップ

データ取得

HeliusでSolanaデータをクエリするすべての方法を探索します。

APIリファレンス

すべてのWallet APIエンドポイントのリクエストおよびレスポンススキーマ。

サポートに連絡

Discord、チャット、メールを通じてサポートを受け取ります。