ウォレットAPIはベータ版です。エンドポイントと応答形式は変更される可能性があります。
ウォレットAPIとは何ですか?
ウォレットAPIは、完全なSolanaウォレットデータを照会するための高レベルなRESTエンドポイントを提供します。残高、取引履歴、トークン転送、身元解決、過去の残高、資金源などです。複数のRPCコールを行い生のブロックチェーンデータを解析する代わりに、構造化された人間が読みやすい情報をUSD価格で1つのリクエストで取得できます。 これは、ウォレット、ポートフォリオトラッカー、エクスプローラー、決済処理業者、税務ツール、コンプライアンスおよびAMLシステム向けに構築されています。すべてのエンドポイントはベースURLhttps://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、チャット、メールを通じてサポートを受け取ります。