So ermittelst du die Identität einer Solana-Wallet

Die Wallet API befindet sich in der Betaphase. Endpoints und response-Formate können sich ändern.

Überblick

Der Wallet Identity endpoint identifiziert bekannte Wallet-Adressen auf Solana. Dazu gehören zentralisierte Börsen, DeFi-Protokolle, Institutionen und andere bekannte Entitäten. Nutze ihn für Compliance, Analysen und zur Anzeige lesbarer Namen für bekannte Adressen. Sowohl der endpoint für Einzelabfragen (GET /v1/wallet/{wallet}/identity) als auch der endpoint für Batch-Abfragen (POST /v1/wallet/batch-identity, bis zu 100 Einträge) akzeptieren neben Solana-Rohadressen auch SNS .sol-Domains und benutzerdefinierte ANS-TLDs (z. B. .bonk, .poor, .abc). Die Domain-Auflösung funktioniert nur im Mainnet. Dieser endpoint verwendet dasselbe Identitätssystem wie Orb, der Solana-Block-Explorer von Helius. Die Datenbank enthält über 32.500 Labels (lesbare Primärnamen, darunter mehr als 3.000 Programme) und über 21,5 Millionen Tags (kategorische Eigenschaften wie „Binance deposit address“ oder „Seeker Phone“) und wächst kontinuierlich. Sowohl der endpoint für Einzelabfragen (GET /v1/wallet/{wallet}/identity) als auch der endpoint für Batch-Abfragen (POST /v1/wallet/batch-identity) erfordern einen kostenpflichtigen Tarif. Requests mit einem API key des kostenlosen Tarifs geben 403 Forbidden zurück. Die vollständige Abdeckungstabelle findest du unter Tarifanforderungen.

Wann du dies verwenden solltest

Verwende die Wallet Identity API, wenn du Folgendes tun möchtest:

Exchange-Wallets identifizieren: Ermittle, ob eine Wallet zu Binance, Coinbase, Kraken oder einer anderen Börse gehört.
Protokollaktivitäten verfolgen: Identifiziere Wallets von DeFi-Protokollen und Treasury-Adressen.
Compliance und AML: Markiere Transaktionen mit bekannten Entitäten.
Analysen: Kategorisiere Wallet-Typen in deiner Daten-Pipeline.
Benutzerfreundlichkeit: Zeige „An Binance 1 gesendet“ statt einer Rohadresse an.
Batch-Verarbeitung: Frage effizient Hunderte Adressen ab.

Schnellstart

Einzelne Wallet abfragen

Rufe Identitätsinformationen für eine einzelne Wallet-Adresse ab:

JavaScript
Python
cURL

const getWalletIdentity = async (address) => {
  const url = `https://api.helius.xyz/v1/wallet/${address}/identity?api-key=YOUR_API_KEY`;

  const response = await fetch(url);
  if (!response.ok) {
    if (response.status === 404) {
      console.log("No identity found for this address");
      return null;
    }
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const identity = await response.json();
  console.log(`Found: ${identity.name} (${identity.category})`);
  return identity;
};

// Example: Binance wallet
getWalletIdentity("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664");

import requests

def get_wallet_identity(address: str):
    url = f"https://api.helius.xyz/v1/wallet/{address}/identity"
    headers = {"X-Api-Key": "YOUR_API_KEY"}

    response = requests.get(url, headers=headers)

    if response.status_code == 404:
        print("No identity found for this address")
        return None

    response.raise_for_status()
    identity = response.json()
    print(f"Found: {identity['name']} ({identity['category']})")
    return identity

# Example: Binance wallet
get_wallet_identity("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664")

curl "https://api.helius.xyz/v1/wallet/HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664/identity?api-key=YOUR_API_KEY"

Nach Domain-Namen suchen

Du kannst auch direkt eine SNS .sol-Domain oder eine benutzerdefinierte ANS-TLD übergeben. Der endpoint löst die Domain auf und gibt die Identität der Besitzeradresse zurück:

JavaScript
Python
cURL

// Works identically — the endpoint resolves the domain first.
const identity = await getWalletIdentity("toly.sol");

// ANS custom TLD
await getWalletIdentity("miester.bonk");

# Works identically — the endpoint resolves the domain first.
identity = get_wallet_identity("toly.sol")

# ANS custom TLD
get_wallet_identity("miester.bonk")

# SNS (.sol) domain
curl "https://api.helius.xyz/v1/wallet/toly.sol/identity?api-key=YOUR_API_KEY"

# ANS custom TLD
curl "https://api.helius.xyz/v1/wallet/miester.bonk/identity?api-key=YOUR_API_KEY"

Die response des endpoint für Einzelabfragen ist das standardmäßige Identitätsobjekt für die aufgelöste Adresse. Es gibt keine inputDomain-Markierung. Wenn du Eingaben den Ausgaben zuordnen musst, etwa beim gleichzeitigen Abfragen vieler Domains, verwende den endpoint für Batch-Abfragen.

Die Domain-Auflösung funktioniert nur im Mainnet. Im Devnet oder Testnet gibt eine Domain-Eingabe an diesen endpoint 400 zurück. Erfolgreiche Auflösungen werden bis zu 2 Stunden zwischengespeichert. Deshalb kann eine kürzlich übertragene Domain kurzzeitig noch zur Identität des vorherigen Besitzers aufgelöst werden.

Batch-Abfrage (bis zu 100 Einträge)

Frage mehrere Einträge für eine bessere Leistung in einem einzigen request ab. Jeder Eintrag kann eine Adresse oder ein Domain-Name sein:

JavaScript
Python
cURL

const batchIdentityLookup = async (addresses) => {
  const url = "https://api.helius.xyz/v1/wallet/batch-identity?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ addresses })
  });

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const identities = await response.json();
  return identities;
};

// Example: Mix addresses and domains in a single request
const addresses = [
  "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664", // Binance (address)
  "toly.sol",                                      // SNS domain
  "miester.bonk"                                   // ANS custom TLD
];

batchIdentityLookup(addresses).then(identities => {
  identities.forEach(identity => {
    if (identity.unresolved) {
      console.log(`${identity.inputDomain}: could not be resolved`);
      return;
    }
    const label = identity.inputDomain
      ? `${identity.inputDomain} → ${identity.address}`
      : identity.address;
    console.log(`${label}: ${identity.name}`);
  });
});

import requests

def batch_identity_lookup(addresses: list[str]):
    url = "https://api.helius.xyz/v1/wallet/batch-identity"
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }

    response = requests.post(
        url,
        headers=headers,
        json={"addresses": addresses}
    )

    response.raise_for_status()
    return response.json()

# Example: Mix addresses and domains in a single request
addresses = [
    "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",  # Binance (address)
    "toly.sol",                                       # SNS domain
    "miester.bonk"                                    # ANS custom TLD
]

identities = batch_identity_lookup(addresses)
for identity in identities:
    if identity.get("unresolved"):
        print(f"{identity['inputDomain']}: could not be resolved")
        continue
    label = f"{identity['inputDomain']} -> {identity['address']}" if identity.get("inputDomain") else identity["address"]
    print(f"{label}: {identity['name']}")

curl -X POST "https://api.helius.xyz/v1/wallet/batch-identity?api-key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
      "toly.sol",
      "miester.bonk"
    ]
  }'

Response-Format

Eine erfolgreiche Einzelabfrage gibt das Identitätsobjekt für die aufgelöste Adresse zurück:

{
  "address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
  "type": "exchange",
  "name": "Binance 1",
  "category": "Centralized Exchange",
  "tags": ["Centralized Exchange"]
}

In einer Batch-response enthält jeder Eintrag, dessen Eingabe ein Domain-Name war, ein zusätzliches Feld inputDomain. Damit kannst du die response dem ursprünglichen request zuordnen:

{
  "address": "7v91N7iZ9mNicL8WfG6cgSCKyRXydQjLh6UYBWwm6y1Q",
  "type": "wallet",
  "name": "toly",
  "category": "Key Opinion Leader",
  "tags": ["Key Opinion Leader"],
  "inputDomain": "toly.sol"
}

Wenn eine Domain in einem Batch-request nicht aufgelöst werden kann, schlägt der Batch nicht fehl. Der Eintrag wird an derselben Position mit address: null, type: "unknown" und unresolved: true zurückgegeben. Die Reihenfolge des request bleibt erhalten:

{
  "address": null,
  "type": "unknown",
  "inputDomain": "nonexistent-xyz.sol",
  "unresolved": true
}

Beim endpoint für Einzelabfragen wird eine 404-response zurückgegeben, wenn für die Wallet kein Identitätseintrag vorhanden ist oder eine eingegebene Domain nicht aufgelöst werden konnte:

{
  "error": "No identity information available for this address",
  "code": 404
}

{
  "error": "Domain 'nonexistent-xyz.sol' could not be resolved",
  "code": 404
}

Identitätskategorien

Wallets und Programme werden anhand der Orb-Identitätsdatenbank in Kategorien eingeordnet. Konten und Programme verwenden separate Kategoriesätze. Die folgenden Tabellen führen alle unterstützten Kategorien auf.

Account tag types

Kategorie	Beschreibung	Beispiele
Centralized Exchange	CEX-Wallets und Hot Wallets	Binance 1, Coinbase 1, Kraken, OKX Exchange 1, Bybit Hot Wallet
Cross-chain Bridge	Adressen von Bridge-Protokollen	Wormhole Bridge, AllBridge, Portal Bridge, deBridge
DeFi	Adressen von DeFi-Protokollen	Jupiter, Raydium, Orca, Marinade Finance, Kamino
Key Opinion Leader	Bekannte Persönlichkeiten und Influencer	Anatoly Yakovenko, Raj Gokal
Market Maker	Market-Making-Unternehmen	Jump Trading, Wintermute, GSR Markets
Trading Firm	Eigenhandelsunternehmen	Alameda Research, DRW Trading
Validator	Adressen von Validatoren und Stake-Pools	Coinbase Validator, Jito Validator, Figment Validator
Treasury	Treasuries von Projekten und Protokollen	Marinade Treasury, Helium Treasury, Solana Foundation Treasury
DAO	Dezentrale autonome Organisationen	Mango DAO, Grape DAO, MonkeDAO Treasury
NFT	NFT-Marktplätze und -Projekte	Magic Eden, Tensor, OpenSea Solana, DeGods Treasury
Stake Pool	Adressen von Liquid-Staking-Pools	Marinade Stake Pool, Jito Stake Pool, BlazeStake
Multisig	Multi-Signatur-Wallets	Squads Multisig, Solana Foundation Multisig
Oracle	Anbieter von Preis-Feeds und Oracles	Pyth Network, Switchboard Oracle, Chainlink Solana
Game	Gaming- und GameFi-Projekte	Star Atlas, Aurory, Genopets Treasury
Payments	Zahlungsdienstleister	Solana Pay, Sphere, Helio Pay
Tools	Entwicklertools und Hilfsprogramme	Phantom Wallet, Backpack, Solflare Wallet
Airdrop	Adressen für die Airdrop-Verteilung	Jupiter Airdrop, Pyth Airdrop Distributor
Governance	Adressen von Governance-Programmen	Realms Governance, SPL Governance
Authority	Programmautoritäten und Administratoren	Token Program Authority, Metaplex Authority
Jito	Jito-spezifische Adressen	Jito Tip 1, Jito Tip 2, Jito MEV Payment
Memecoin	Memecoin-Projekte	Bonk Treasury, Dogwifhat, Book of Meme
Casino & Gambling	Glücksspiel- und Casino-dApps	Stake.com Hot Wallet, Rollbit, DexSport
DePIN	Dezentrale physische Infrastruktur	Helium Network, Render Network, Hivemapper
Proprietary AMM	Benutzerdefinierte AMM-Implementierungen	Phoenix DEX, GooseFX
Restaking	Restaking-Protokolle	Solayer, Fragmetric
Vault	Vault- und Verwahrungsadressen	Solend Vault, Tulip Vault, Francium Vault
Fees	Adressen zur Gebührenerhebung	Jupiter Fee Collector, Raydium Fees
Fundraise	Adressen für Fundraising und ICOs	Token Sale Wallet, Fundraise Multisig
Genesis Block Distribution	Adressen der Genesis-Verteilung	Solana Genesis Distribution
Non-Circulating Supply	Adressen nicht im Umlauf befindlicher Token	Team Vesting Wallet, Foundation Reserve
Transaction Sending	Dienste zum Senden von Transaktionen	Jito Tip 1, Jito Tip 2, Helius Sender Tip 1
System	Solana-Systemprogramme	System Program, Config Program
X402	Adressen des X402-Protokolls	X402 Protocol
Other	Nicht kategorisierte bekannte Adressen	Verschiedene bekannte Wallets

Malicious categories

Kategorie	Beschreibung	Beispiele
Exploiter, Hackers & Scams	Bekannte Adressen von Exploits und Hacks	Wormhole Exploiter Wallet, SagaDAO Hacker Wallet, Mango Exploiter
Hacker	Bestätigte Hacker-Adressen	Solana Hack 2022, DeFi Protocol Hacker
Rugger	Verantwortliche für Rug Pulls	Squid Game Token Rugger, Known Rug Pull Wallet
Scammer	Bestätigte Betrugsadressen	Fake Airdrop Scammer, Phishing Scam Wallet
Spam	Ersteller von Spam-Token	Spam Token Creator, Airdrop Spammer

Program categories

Programme (Smart Contracts) werden separat klassifiziert:

Kategorie	Beschreibung	Beispiele
Swap	Protokolle für den Token-Tausch	Jupiter, Raydium, Orca
DeFi	Allgemeine DeFi-Protokolle	Drift, Mango
Borrow Lend	Lending-Protokolle	Solend, MarginFi
NFT	NFT-Marktplätze	Magic Eden, Tensor
Staking	Staking-Programme	Marinade, Jito
Bridge	Cross-Chain-Bridges	Wormhole, AllBridge
Aggregator	DEX-Aggregatoren	Jupiter Aggregator
Perpetuals	Unbefristete Futures	Drift, Mango
Oracle	Oracle-Anbieter	Pyth, Switchboard
Launchpad	Plattformen für Token-Launches	Raydium Launchpad
Governance	Governance-Programme	SPL Governance
Game or Casino	Gaming-Programme	Star Atlas
Prediction Market	Prognosemärkte	Drift Predictions
Payments	Zahlungsprotokolle	Solana Pay
Privacy	Datenschutzprotokolle	Elusiv
Compression	Zustandskomprimierung	Bubblegum
Infrastructure	Kerninfrastruktur	Metaplex
Tools	Entwicklertools	Clockwork
RWA	Reale Vermögenswerte	Ondo Finance
DePIN	Dezentrale Infrastruktur	Helium, Render
DeSci	Dezentrale Wissenschaft	VitaDAO
Airdrop	Airdrop-Programme	Merkle-Verteiler
Web3	Web3-Anwendungen	Verschiedene
Native	Native Solana-Programme	System Program
Proprietary AMM	Benutzerdefinierte AMM-Designs	Phoenix
Trading Sniper	Trading-Bots	MEV-Bots
Arbitrage or Sandwich Bot	MEV- und Arbitrage-Bots	Jito-Bundles
Spam	Spam-Programme	Spam-Token
Other	Nicht kategorisierte Programme	Verschiedene

Anwendungsfälle

Einzahlungen bei Börsen markieren

Erkenne, wenn Gelder an eine zentralisierte Börse gesendet werden:

const checkIfExchange = async (address) => {
  try {
    const identity = await getWalletIdentity(address);
    if (identity && identity.category === "Centralized Exchange") {
      console.log(`Funds sent to ${identity.name}`);
      return true;
    }
  } catch (error) {
    // Not a known exchange
  }
  return false;
};

Lesbare Namen anzeigen

Zeige in deiner Benutzeroberfläche aussagekräftige Namen statt Adressen an:

const getDisplayName = async (address) => {
  try {
    const identity = await getWalletIdentity(address);
    return identity ? identity.name : shortenAddress(address);
  } catch (error) {
    return shortenAddress(address);
  }
};

// Usage in UI
const displayName = await getDisplayName("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664");
// Returns: "Binance 1" instead of "HXsKP...G664"

Transaktionsgegenparteien als Batch verarbeiten

Identifiziere effizient alle Gegenparteien in einer Liste von Transaktionen:

const identifyTransactionCounterparties = async (transactions) => {
  // Extract all unique addresses
  const addresses = [...new Set(
    transactions.map(tx => tx.counterparty)
  )];

  // Batch lookup (up to 100 at a time)
  const allIdentities = [];
  for (let i = 0; i < addresses.length; i += 100) {
    const chunk = addresses.slice(i, i + 100);
    const identities = await batchIdentityLookup(chunk);
    allIdentities.push(...identities);
  }

  // Create a map for quick lookup
  const identityMap = new Map(
    allIdentities.map(id => [id.address, id])
  );

  // Enrich transactions with identity info
  return transactions.map(tx => ({
    ...tx,
    counterpartyName: identityMap.get(tx.counterparty)?.name || "Unknown"
  }));
};

Best Practices

Verwende den endpoint für Batch-Abfragen für mehrere Abfragen. Wenn du mehr als eine Adresse abfragst, ist POST /v1/wallet/batch-identity deutlich schneller als einzelne requests.
Behandle 404-responses korrekt. Nicht für jede Wallet sind Identitätsinformationen verfügbar. Zeige ersatzweise die Rohadresse an.
Speichere Ergebnisse im Cache. Identitätsdaten ändern sich selten. Speichere sie lokal zwischen, um API-Aufrufe zu reduzieren.
Beachte das Limit für die Batch-Größe. Der endpoint für Batch-Abfragen unterstützt bis zu 100 Einträge pro request. Teile größere Datensätze entsprechend auf.

Häufige Fehler

Fehlercode	Beschreibung	Lösung
400	Ungültige Wallet-Adresse oder ungültiges Domain-Format beziehungsweise Domain-Eingabe außerhalb des Mainnets	Prüfe, ob die Eingabe eine gültige Solana-Adresse im base58-Format oder eine korrekt formatierte Domain ist (z. B. `toly.sol`) und ob du das Mainnet verwendest
401	Fehlender oder ungültiger API key	Prüfe, ob dein API key im request enthalten ist
403	Der endpoint erfordert einen kostenpflichtigen Tarif	Identitätsabfragen sind im kostenlosen Tarif nicht verfügbar. Führe ein Upgrade auf einen kostenpflichtigen Tarif durch
404	Keine Identität gefunden oder Domain konnte nicht aufgelöst werden	Gilt nur für den endpoint für Einzelabfragen: Für die Wallet ist kein Identitätseintrag vorhanden oder die Domain existiert nicht. In Batch-requests werden nicht auflösbare Domains als `unresolved: true`-Einträge statt als 404-response zurückgegeben
429	Rate limit überschritten	Reduziere die Häufigkeit der requests oder führe ein Tarif-Upgrade durch

Nächste Schritte

Funding Source

Ermittle, wer eine Wallet ursprünglich finanziert hat. Die Finanzierer-Typen verwenden diese Identitätskategorien ebenfalls.

Wallet API Overview

Alle Endpoints der Wallet API und gemeinsame Konventionen.

API Reference

Request- und response-Schemas für die Identitätsabfrage.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

So ermittelst du die Identität einer Solana-Wallet

Überblick

Wann du dies verwenden solltest

Schnellstart

Einzelne Wallet abfragen

Nach Domain-Namen suchen

Batch-Abfrage (bis zu 100 Einträge)

Response-Format

Identitätskategorien

Anwendungsfälle

Einzahlungen bei Börsen markieren

Lesbare Namen anzeigen

Transaktionsgegenparteien als Batch verarbeiten

Best Practices

Häufige Fehler

Nächste Schritte

Funding Source

Wallet API Overview

API Reference

​Überblick

​Wann du dies verwenden solltest

​Schnellstart

​Einzelne Wallet abfragen

​Nach Domain-Namen suchen

​Batch-Abfrage (bis zu 100 Einträge)

​Response-Format

​Identitätskategorien

​Anwendungsfälle

​Einzahlungen bei Börsen markieren

​Lesbare Namen anzeigen

​Transaktionsgegenparteien als Batch verarbeiten

​Best Practices

​Häufige Fehler

​Nächste Schritte

Funding Source

Wallet API Overview

API Reference

Überblick

Wann du dies verwenden solltest

Schnellstart

Einzelne Wallet abfragen

Nach Domain-Namen suchen

Batch-Abfrage (bis zu 100 Einträge)

Response-Format

Identitätskategorien

Anwendungsfälle

Einzahlungen bei Börsen markieren

Lesbare Namen anzeigen

Transaktionsgegenparteien als Batch verarbeiten

Best Practices

Häufige Fehler

Nächste Schritte