So finden Sie eine Solana Wallet-Identität

Die Wallet API befindet sich im Beta-Stadium. Endpunkte und Antwortformate können sich ändern.

Überblick

Der Wallet Identity Endpoint identifiziert bekannte Wallet-Adressen auf Solana, einschließlich zentralisierter Börsen, DeFi-Protokolle, Institutionen und anderer anerkannter Einheiten. Verwenden Sie ihn für Compliance, Analysen und zur Anzeige von menschenlesbaren Namen für bekannte Adressen. Sowohl der einzelne (GET /v1/wallet/{wallet}/identity) als auch der Batch-Endpunkt (POST /v1/wallet/batch-identity, bis zu 100 Einträge) akzeptieren SNS .sol Domains und ANS benutzerdefinierte TLDs (z. B. .bonk, .poor, .abc) zusätzlich zu rohen Solana-Adressen. Die Domain-Auflösung erfolgt nur im Mainnet. Dieser Endpunkt verwendet dasselbe Identitätssystem, das Orb, den Helius Solana Block Explorer, antreibt. Die Datenbank umfasst über 32.500 Labels (menschenlesbare primäre Namen, darunter über 3.000 Programme) und mehr als 21,5 Millionen Tags (kategorische Eigenschaften wie “Binance-Einzahlungsadresse” oder “Seeker Phone”) und wächst kontinuierlich. Sowohl der einzelne (GET /v1/wallet/{wallet}/identity) als auch der Batch-Endpunkt (POST /v1/wallet/batch-identity) erfordern einen kostenpflichtigen Plan. Anfragen mit einem Free-Plan-API-Schlüssel geben 403 Forbidden zurück. Siehe Plananforderungen für die vollständige Abdeckungstabelle.

Wann sollte man dies verwenden

Verwenden Sie die Wallet Identity API, wenn Sie:

Exchange-Wallets identifizieren müssen: bestimmen, ob eine Wallet zu Binance, Coinbase, Kraken und anderen gehört.
Protokollaktivitäten verfolgen: DeFi-Protokoll-Wallets und Treasury-Adressen identifizieren.
Compliance und AML: Transaktionen mit bekannten Entitäten kennzeichnen.
Analytik: Wallet-Typen in Ihrer Datenpipeline kategorisieren.
Benutzererfahrung: “Gesendet an Binance 1” anstelle einer rohen Adresse anzeigen.
Batch-Verarbeitung: Hunderte von Adressen effizient nachschlagen.

Schnellstart

Einzelnes Wallet-Nachschlagen

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

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"

Nachschlagen nach Domainnamen

Sie können auch eine SNS .sol Domain oder eine ANS benutzerdefinierte TLD direkt übergeben — der Endpunkt 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 Antwort des Einzelnachschlageendpunkts ist das Standard-Identitätsobjekt für die aufgelöste Adresse — es gibt keinen inputDomain Marker. Wenn Sie Eingaben mit Ausgaben korrelieren müssen (zum Beispiel, wenn Sie viele Domains auf einmal nachschlagen), verwenden Sie den Batch-Endpunkt.

Die Domain-Auflösung erfolgt nur im Mainnet. Auf devnet/testnet gibt eine Domain-Eingabe zu diesem Endpunkt 400 zurück. Positive Auflösungen werden bis zu 2 Stunden zwischengespeichert, sodass eine kürzlich übertragene Domain möglicherweise kurzzeitig auf die Identität des vorherigen Besitzers aufgelöst wird.

Batch-Nachschlagen (bis zu 100 Einträge)

Suchen Sie mehrere Einträge in einer einzigen Anfrage für eine bessere Leistung. Jeder Eintrag kann entweder eine Adresse oder ein Domainname 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"
    ]
  }'

Antwortformat

Ein erfolgreiches Einzelnachschlagen 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-Antwort trägt jeder Eintrag, dessen Eingabe ein Domainname war, ein zusätzliches inputDomain Feld, damit Sie die Antwort zurück zur ursprünglichen Anfrage korrelieren können:

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

Wenn eine Domain in einer Batch-Anfrage nicht aufgelöst werden kann, schlägt der Batch nicht fehl — der Eintrag wird an Ort und Stelle mit address: null, type: "unknown" und unresolved: true zurückgegeben. Die Anfragenreihenfolge bleibt erhalten:

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

Beim einzelnen Endpunkt wird eine 404 zurückgegeben, wenn das Wallet keinen Identitätseintrag hat oder wenn eine Domaineingabe 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 in Kategorien klassifiziert, die von der Orb-Identitätsdatenbank betrieben werden. Konten und Programme verwenden separate Kategorie-Sets. Die folgenden Tabellen listen jede unterstützte Kategorie auf.

Kontotyp-Tags

Kategorie	Beschreibung	Beispiele
Centralized Exchange	CEX-Wallets und Hot Wallets	Binance 1, Coinbase 1, Kraken, OKX Exchange 1, Bybit Hot Wallet
Cross-chain Bridge	Bridge-Protokolladressen	Wormhole Bridge, AllBridge, Portal Bridge, deBridge
DeFi	DeFi-Protokolladressen	Jupiter, Raydium, Orca, Marinade Finance, Kamino
Key Opinion Leader	Bedeutende Persönlichkeiten und Influencer	Anatoly Yakovenko, Raj Gokal
Market Maker	Market-Making-Firmen	Jump Trading, Wintermute, GSR Markets
Trading Firm	Proprietäre Handelsfirmen	Alameda Research, DRW Trading
Validator	Validator- und Stake-Pool-Adressen	Coinbase Validator, Jito Validator, Figment Validator
Treasury	Projekte und Protokollschätze	Marinade Treasury, Helium Treasury, Solana Foundation Treasury
DAO	Dezentralisierte autonome Organisationen	Mango DAO, Grape DAO, MonkeDAO Treasury
NFT	NFT-Marktplätze und Projekte	Magic Eden, Tensor, OpenSea Solana, DeGods Treasury
Stake Pool	Liquiditätsbetreuungsadressen	Marinade Stake Pool, Jito Stake Pool, BlazeStake
Multisig	Multi-Signatur-Wallets	Squads Multisig, Solana Foundation Multisig
Oracle	Preis-Feed- und Orakel-Anbieter	Pyth Network, Switchboard Oracle, Chainlink Solana
Game	Gaming- und GameFi-Projekte	Star Atlas, Aurory, Genopets Treasury
Payments	Zahlungsprozessoren	Solana Pay, Sphere, Helio Pay
Tools	Entwickler-Tools und Dienstprogramme	Phantom Wallet, Backpack, Solflare Wallet
Airdrop	Airdrop-Verteilungsadressen	Jupiter Airdrop, Pyth Airdrop Distributor
Governance	Governance-Programm-Adressen	Realms Governance, SPL Governance
Authority	Programmbehörden 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	Dezentralisierte physische Infrastruktur	Helium Network, Render Network, Hivemapper
Proprietary AMM	Custom AMM Implementierungen	Phoenix DEX, GooseFX
Restaking	Restaking-Protokolle	Solayer, Fragmetric
Vault	Tresor- und Verwahradresssen	Solend Vault, Tulip Vault, Francium Vault
Fees	Gebühreneinzugsadressen	Jupiter Fee Collector, Raydium Fees
Fundraise	Fundraising- und ICO-Adressen	Token Sale Wallet, Fundraise Multisig
Genesis Block Distribution	Genesis-Verteilungsadressen	Solana Genesis Distribution
Non-Circulating Supply	Nicht zirkulierende Token-Adressen	Team Vesting Wallet, Foundation Reserve
Transaction Sending	Transaktionssendungsdienste	Jito Tip 1, Jito Tip 2, Helius Sender Tip 1
System	Solana-Systemprogramme	System Program, Config Program
X402	X402-Protokoll-Adressen	X402 Protocol
Other	Nicht kategorisierte bekannte Adressen	Verschiedene bekannte Wallets

Bösartige Kategorien

Kategorie	Beschreibung	Beispiele
Exploiter, Hackers & Scams	Bekannte Exploit- und Hack-Adressen	Wormhole Exploiter Wallet, SagaDAO Hacker Wallet, Mango Exploiter
Hacker	Bestätigte Hacker-Adressen	Solana Hack 2022, DeFi-Protokoll-Hacker
Rugger	Rug-Pull-Verursacher	Squid Game Token Rugger, Bekannte Rug-Pull-Wallet
Scammer	Bestätigte Betrugsadressen	Fake Airdrop Scammer, Phishing Scam Wallet
Spam	Spam-Token-Ersteller	Spam-Token-Ersteller, Airdrop-Spammer

Programmkategorien

Programme (Smart Contracts) werden separat klassifiziert:

Kategorie	Beschreibung	Beispiele
Swap	Token-Swap-Protokolle	Jupiter, Raydium, Orca
DeFi	Allgemeine DeFi-Protokolle	Drift, Mango
Borrow Lend	Kreditvergabeprotokolle	Solend, MarginFi
NFT	NFT-Marktplätze	Magic Eden, Tensor
Staking	Staking-Programme	Marinade, Jito
Bridge	Cross-Chain-Brücken	Wormhole, AllBridge
Aggregator	DEX-Aggregatoren	Jupiter Aggregator
Perpetuals	Perpetual-Futures	Drift, Mango
Oracle	Orakel-Anbieter	Pyth, Switchboard
Launchpad	Token-Launchpads	Raydium Launchpad
Governance	Governance-Programme	SPL Governance
Game or Casino	Gaming-Programme	Star Atlas
Prediction Market	Vorhersagemärkte	Drift Predictions
Payments	Zahlungsprotokolle	Solana Pay
Privacy	Datenschutzprotokolle	Elusiv
Compression	Zustandkompression	Bubblegum
Infrastructure	Kerninfrastruktur	Metaplex
Tools	Entwicklerwerkzeuge	Clockwork
RWA	Reale Vermögenswerte	Ondo Finance
DePIN	Dezentralisierte Infrastruktur	Helium, Render
DeSci	Dezentralisierte Wissenschaft	VitaDAO
Airdrop	Airdrop-Programme	Merkle distributors
Web3	Web3-Anwendungen	Verschiedene
Native	Solana-native Programme	System Program
Proprietary AMM	Custom AMM Designs	Phoenix
Trading Sniper	Handels-Bots	MEV bots
Arbitrage or Sandwich Bot	MEV- und Arb-Bots	Jito bundles
Spam	Spam-Programme	Spam tokens
Other	Nicht kategorisierte Programme	Verschiedene

Anwendungsfälle

Exchange-Einzahlungen kennzeichnen

Ermitteln, wann 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;
};

Anzeigen von menschenlesbaren Namen

Zeigen Sie in Ihrer Benutzeroberfläche freundliche Namen anstelle von 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"

Batch-Verarbeitung von Transaktionsgegenparteien

Identifizieren Sie 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

Verwenden Sie den Batch-Endpunkt für mehrere Nachschlagen. Wenn Sie mehr als eine Adresse nachschlagen, ist POST /v1/wallet/batch-identity erheblich schneller als einzelne Anfragen zu stellen.
Behandeln Sie 404-Antworten mit Sorgfalt. Nicht alle Wallets haben Identitätsinformationen. Zeigen Sie stattdessen die rohe Adresse an.
Ergebnisse zwischenspeichern. Identitätsdaten ändern sich selten. Lokal zwischenspeichern, um API-Aufrufe zu reduzieren.
Beachten Sie die Batch-Größenbegrenzung. Der Batch-Endpunkt unterstützt bis zu 100 Einträge pro Anfrage. Größere Datensätze entsprechend aufteilen.

Häufige Fehler

Fehlercode	Beschreibung	Lösung
400	Ungültiges Wallet-Adresse- oder Domain-Format oder Domaineingabe im Nicht-Mainnet	Überprüfen Sie, ob die Eingabe eine gültige Base58-Solana-Adresse oder eine gut geformte Domain (z. B. `toly.sol`) ist und dass das Mainnet anvisiert wird
401	Fehlender oder ungültiger API-Schlüssel	Stellen Sie sicher, dass Ihr API-Schlüssel in der Anfrage enthalten ist
403	Endpunkt erfordert einen kostenpflichtigen Plan	Identitätsabfragen sind im kostenlosen Plan nicht verfügbar. Upgrade Ihren Plan auf eine kostenpflichtige Stufe
404	Keine Identität gefunden oder Domain konnte nicht aufgelöst werden	Nur für Einzelendpunkt — das Wallet hat keinen Identitätseintrag oder die Domain existiert nicht. In Batch-Anfragen werden nicht auflösbare Domains als `unresolved: true` Einträge statt 404 zurückgegeben
429	Ratenbegrenzung überschritten	Häufigkeit der Anfragen verringern oder Plan aktualisieren

Nächste Schritte

Finanzierungsquelle

Verfolgen Sie, wer ursprünglich ein Wallet finanziert hat — Finanzierungsarten verwenden diese Identitätskategorien erneut.

Wallet API Überblick

Alle Wallet API-Endpunkte und gemeinsamen Konventionen.

API-Referenz

Anforderungs- und Antwortschemata für Identitätsabfrage.

Erste Schritte

Daten-Streaming & Ereignisüberwachung

Daten-APIs & RPCs

Handel

Transaktionen senden

Wallet-as-a-Service

Privatsphäre

Ressourcen

So finden Sie eine Solana Wallet-Identität

Überblick

Wann sollte man dies verwenden

Schnellstart

Einzelnes Wallet-Nachschlagen

Nachschlagen nach Domainnamen

Batch-Nachschlagen (bis zu 100 Einträge)

Antwortformat

Identitätskategorien

Anwendungsfälle

Exchange-Einzahlungen kennzeichnen

Anzeigen von menschenlesbaren Namen

Batch-Verarbeitung von Transaktionsgegenparteien

Best Practices

Häufige Fehler

Nächste Schritte

Finanzierungsquelle

Wallet API Überblick

API-Referenz

​Überblick

​Wann sollte man dies verwenden

​Schnellstart

​Einzelnes Wallet-Nachschlagen

​Nachschlagen nach Domainnamen

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

​Antwortformat

​Identitätskategorien

​Anwendungsfälle

​Exchange-Einzahlungen kennzeichnen

​Anzeigen von menschenlesbaren Namen

​Batch-Verarbeitung von Transaktionsgegenparteien

​Best Practices

​Häufige Fehler

​Nächste Schritte

Finanzierungsquelle

Wallet API Überblick

API-Referenz

Überblick

Wann sollte man dies verwenden

Schnellstart

Einzelnes Wallet-Nachschlagen

Nachschlagen nach Domainnamen

Batch-Nachschlagen (bis zu 100 Einträge)

Antwortformat

Identitätskategorien

Anwendungsfälle

Exchange-Einzahlungen kennzeichnen

Anzeigen von menschenlesbaren Namen

Batch-Verarbeitung von Transaktionsgegenparteien

Best Practices

Häufige Fehler

Nächste Schritte