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

概要

ウォレット資金提供ソースエンドポイントは、最初のSOL受取転送を分析することで、Solanaウォレットを最初に資金提供した人を特定します。これは、帰属、コンプライアンス、ウォレットの関係の理解、取引所資金提供ウォレットの識別に役立ちます。 資金提供者の名前とカテゴリは、Identityエンドポイントで使用される同じアイデンティティシステムから取得されるため、資金提供者が既知のエンティティの場合、レスポンスに直接人間が読み取れるラベルとカテゴリが表示されます。 このエンドポイントは有料プランが必要です。無料プランのAPIキーで行われた要求には403 Forbiddenが返されます。完全なカバレッジテーブルについては、プランの要件を参照してください。

使用タイミング

ウォレット資金提供ソースAPIの使用用途:
  • ウォレットの帰属:新しいウォレットがどこから資金提供されているかを追跡。
  • 取引所の検出:中央集権型取引所から直接資金提供されたウォレットを識別。
  • コンプライアンスとAML:既知のエンティティから資金提供されたウォレットをコンプライアンスチェックのためにフラグ。
  • ボットの検出:同じソースから資金提供されたボットファームを識別。
  • エアドロップ分析:プロジェクトから初期資金を受け取ったウォレットを追跡。
  • Sybil検出:同じアドレスから資金提供されたウォレットのクラスターを見つける。

クイックスタート

基本的な資金調達の検索

ウォレットに資金を提供したのは誰かを確認する:

レスポンス形式

成功したレスポンスはウォレットの最初のSOL受取転送を説明します:
ウォレットが一度もSOLを受け取っていない場合、APIは404を返します:

フィールドノート

  • funder: このウォレットに最初のSOL転送を送信したアドレス。
  • funderName: 資金提供者が既知のエンティティ(例:取引所、プロトコル)である場合の人が読み取れる名前。それ以外の場合はnull
  • funderType: 資金提供者のカテゴリ(例:exchange, defi-protocol);アイデンティティデータベースにない場合はnull
  • mint: トークンミントアドレス(SOLの場合はSo11111111111111111111111111111111111111111)。
  • symbol: トークンシンボル(資金調達トランザクションの場合は常にSOL)。
  • amount: 受け取った最初のSOLの量(人が読み取れる形式、例:0.05 SOL)。
  • amountRaw: lamportsでの生の金額(例えば0.05 SOLに対しては"50000000")。
  • decimals: トークンの小数点以下の桁数(SOLの場合は9)。
  • date: ISO 8601形式の日付文字列(例:"2024-01-01T00:00:00.000Z")。
  • signature: 資金移転のトランザクションシグネチャ。
  • timestamp: ウォレットが資金提供を受けたときのUnixタイムスタンプ(秒単位)。
  • slot: 資金調達トランザクションが確認されたときのSolanaスロット番号。
  • explorerUrl: Orbでトランザクションを表示するための直接リンク。

ユースケース

取引所で資金提供されたウォレットを検出

中央集権型取引所から直接資金提供されたウォレットを識別:

ウォレットクラスターを見つける(Sybil検出)

同じソースから資金提供されたウォレットのグループを特定する:

エアドロップ受取人を追跡

エアドロップ受取人がどこから来たのかを分析する:

ウォレットタイムラインの構築

ウォレットの作成から始めるタイムラインを作成する:

コンプライアンスリスクスコアリング

資金提供ソースに基づいてリスクスコアを割り当てる:

帰属追跡

最も多くの新しいウォレットを作成しているソースを追跡する:

資金提供者の種類

funderTypeフィールドは、アドレスに資金を提供したウォレットのカテゴリを示します。Identity Categoriesからすべての値がサポートされています。
一般的な資金提供者の種類:完全なリストには次のものが含まれます:エアドロップ、権限、クロスチェーンブリッジ、カジノ&ギャンブル、DAO、DeFi、DePIN、中央集権型取引所、エクスプロイト/ハッカー/詐欺、料金、資金調達、ゲーム、ジェネシスブロック配布、ガバナンス、ハッカー、Jito、オピニオンリーダー、マーケットメーカー、ミームコイン、マルチシグ、NFT、非流通供給、オラクル、その他、支払い、プロプライエタリーAMM、再ステーキング、ラガー、スキャマー、スパム、ステークプール、システム、ツール、取引アプリ/ボット、取引会社、トランザクション送信、トレジャリー、バリデーター、ボールト、X402。完全なリストと説明については、Identity Categoriesセクションを参照してください。

ベストプラクティス

  • 404レスポンスを処理する。 SOLを一度も受け取っていないウォレットは404を返します。これは未資金の新しく作成されたウォレットでは予期されるものです。
  • Identity APIと組み合わせる。 レスポンスにはfunderNamefunderTypeが含まれていますが、さらに詳細を得るためにIdentityエンドポイントにfunderアドレスを呼び出すことができます。
  • 資金データをキャッシュする。 ウォレットの資金提供ソースは変更されません。このデータを永続的にキャッシュして、繰り返しのAPI呼び出しを避けます。
  • コンテキストに年齢を確認する。 timestampはウォレットが最初に資金提供されたときを教えてくれます。コンテキスト向上のために年齢と資金提供ソースを組み合わせます。

よくあるエラー

制限

  • このエンドポイントはウォレットへの 最初のSOL転送 のみを追跡します。
  • ウォレットがエアドロップやプログラムの初期化でSOL転送なしに作成された場合、資金データはありません。
  • 資金提供ソースは 直接の 資金提供者を示し、必ずしも最終的な資金の出所を示すものではありません。
  • 歴史的データは、この機能が展開された後に作成されたウォレットに対してのみ利用可能です。

次のステップ

ウォレットアイデンティティ

資金提供者のアドレスを完全なラベル、カテゴリ、タグに解決します。

ウォレットAPI概要

すべてのウォレットAPIエンドポイントと共有規約。

APIリファレンス

資金ソースルックアップのリクエストとレスポンスのスキーマ。