Как определить владельца кошелька Solana

Wallet API находится на этапе бета-тестирования. Эндпоинты и форматы ответов могут измениться.

Обзор

Эндпоинт Wallet Identity идентифицирует известные адреса кошельков в Solana, включая централизованные биржи, протоколы DeFi, организации и другие распознаваемые сущности. Используйте его для обеспечения соответствия требованиям, аналитики и отображения понятных пользователю названий известных адресов. Эндпоинты для одиночного (GET /v1/wallet/{wallet}/identity) и пакетного поиска (POST /v1/wallet/batch-identity, до 100 записей) принимают домены SNS .sol и пользовательские TLD ANS (например, .bonk, .poor, .abc), а также необработанные адреса Solana. Разрешение доменов доступно только в основной сети. Этот эндпоинт использует ту же систему идентификации, на которой работает Orb — обозреватель блоков Solana от Helius. База данных содержит более 32 500 меток (понятных пользователю основных названий, включая более 3 000 программ) и более 21,5 млн тегов (категориальных свойств, таких как «адрес для пополнения Binance» или «телефон Seeker») и непрерывно пополняется. Для эндпоинтов одиночного (GET /v1/wallet/{wallet}/identity) и пакетного поиска (POST /v1/wallet/batch-identity) требуется платный тариф. Запросы с ключом API бесплатного тарифа возвращают 403 Forbidden. Полную таблицу доступности см. в разделе Требования к тарифу.

Когда использовать

Используйте Wallet Identity API, когда вам необходимо:

Определять кошельки бирж: выяснять, принадлежит ли кошелек Binance, Coinbase, Kraken или другой бирже.
Отслеживать активность протоколов: определять кошельки протоколов DeFi и адреса казначейств.
Обеспечивать соответствие требованиям и AML: отмечать транзакции с участием известных сущностей.
Выполнять аналитику: классифицировать типы кошельков в конвейере данных.
Улучшать пользовательский интерфейс: отображать «Отправлено на Binance 1» вместо необработанного адреса.
Выполнять пакетную обработку: эффективно искать сотни адресов.

Быстрый старт

Поиск одного кошелька

Получите идентификационные данные для одного адреса кошелька:

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"

Поиск по доменному имени

Вы также можете напрямую передать домен SNS .sol или пользовательский TLD ANS — эндпоинт разрешит домен и вернет идентификационные данные адреса владельца:

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"

Ответ эндпоинта одиночного поиска представляет собой стандартный объект идентификации для разрешенного адреса — маркер inputDomain отсутствует. Если необходимо сопоставить входные данные с результатами, например при одновременном поиске нескольких доменов, используйте эндпоинт пакетного поиска.

Разрешение доменов доступно только в основной сети. В devnet/testnet передача домена этому эндпоинту возвращает 400. Успешные результаты разрешения кешируются на срок до 2 часов, поэтому недавно переданный домен может некоторое время разрешаться в идентификационные данные предыдущего владельца.

Пакетный поиск (до 100 записей)

Чтобы повысить производительность, ищите несколько записей одним запросом. Каждая запись может быть адресом или доменным именем:

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"
    ]
  }'

Формат ответа

При успешном одиночном поиске возвращается объект идентификации разрешенного адреса:

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

В пакетном ответе каждая запись, для которой в качестве входных данных использовалось доменное имя, содержит дополнительное поле inputDomain. Оно позволяет сопоставить ответ с исходным запросом:

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

Если домен из пакетного запроса не удается разрешить, весь пакет не завершается с ошибкой. Запись возвращается на своем месте с address: null, type: "unknown" и unresolved: true. Порядок запросов сохраняется:

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

Эндпоинт одиночного поиска возвращает ошибку 404, если для кошелька нет идентификационной записи или если переданный домен не удалось разрешить:

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

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

Категории идентификации

Кошельки и программы распределяются по категориям на основе базы идентификационных данных Orb. Для учетных записей и программ используются разные наборы категорий. В таблицах ниже перечислены все поддерживаемые категории.

Account tag types

Категория	Описание	Примеры
Централизованная биржа	Кошельки CEX и горячие кошельки	Binance 1, Coinbase 1, Kraken, OKX Exchange 1, Bybit Hot Wallet
Межсетевой мост	Адреса протоколов мостов	Wormhole Bridge, AllBridge, Portal Bridge, deBridge
DeFi	Адреса протоколов DeFi	Jupiter, Raydium, Orca, Marinade Finance, Kamino
Лидер мнений	Известные лица и инфлюенсеры	Anatoly Yakovenko, Raj Gokal
Маркетмейкер	Маркетмейкерские компании	Jump Trading, Wintermute, GSR Markets
Торговая компания	Компании, торгующие за свой счет	Alameda Research, DRW Trading
Валидатор	Адреса валидаторов и пулов стейкинга	Coinbase Validator, Jito Validator, Figment Validator
Казначейство	Казначейства проектов и протоколов	Marinade Treasury, Helium Treasury, Solana Foundation Treasury
DAO	Децентрализованные автономные организации	Mango DAO, Grape DAO, MonkeDAO Treasury
NFT	Маркетплейсы и проекты NFT	Magic Eden, Tensor, OpenSea Solana, DeGods Treasury
Пул стейкинга	Адреса пулов ликвидного стейкинга	Marinade Stake Pool, Jito Stake Pool, BlazeStake
Мультиподпись	Кошельки с мультиподписью	Squads Multisig, Solana Foundation Multisig
Оракул	Поставщики ценовых данных и оракулов	Pyth Network, Switchboard Oracle, Chainlink Solana
Игра	Игровые проекты и проекты GameFi	Star Atlas, Aurory, Genopets Treasury
Платежи	Обработчики платежей	Solana Pay, Sphere, Helio Pay
Инструменты	Инструменты и утилиты для разработчиков	Phantom Wallet, Backpack, Solflare Wallet
Аирдроп	Адреса распространения аирдропов	Jupiter Airdrop, Pyth Airdrop Distributor
Управление	Адреса программ управления	Realms Governance, SPL Governance
Полномочия	Уполномоченные адреса и администраторы программ	Token Program Authority, Metaplex Authority
Jito	Адреса, относящиеся к Jito	Jito Tip 1, Jito Tip 2, Jito MEV Payment
Мемкоин	Проекты мемкоинов	Bonk Treasury, Dogwifhat, Book of Meme
Казино и азартные игры	dApp для азартных игр и казино	Stake.com Hot Wallet, Rollbit, DexSport
DePIN	Децентрализованная физическая инфраструктура	Helium Network, Render Network, Hivemapper
Собственный AMM	Пользовательские реализации AMM	Phoenix DEX, GooseFX
Рестейкинг	Протоколы рестейкинга	Solayer, Fragmetric
Хранилище	Адреса хранилищ и кастодиального хранения	Solend Vault, Tulip Vault, Francium Vault
Комиссии	Адреса сбора комиссий	Jupiter Fee Collector, Raydium Fees
Сбор средств	Адреса сбора средств и ICO	Token Sale Wallet, Fundraise Multisig
Распределение генезис-блока	Адреса первоначального распределения	Solana Genesis Distribution
Нециркулирующее предложение	Адреса токенов вне обращения	Team Vesting Wallet, Foundation Reserve
Отправка транзакций	Сервисы отправки транзакций	Jito Tip 1, Jito Tip 2, Helius Sender Tip 1
Система	Системные программы Solana	System Program, Config Program
X402	Адреса протокола X402	X402 Protocol
Другое	Известные адреса без категории	Различные известные кошельки

Malicious categories

Категория	Описание	Примеры
Эксплуататоры, хакеры и мошенники	Известные адреса, связанные с эксплуатацией уязвимостей и взломами	Wormhole Exploiter Wallet, SagaDAO Hacker Wallet, Mango Exploiter
Хакер	Подтвержденные адреса хакеров	Solana Hack 2022, DeFi Protocol Hacker
Организатор рагпула	Организаторы рагпулов	Squid Game Token Rugger, Known Rug Pull Wallet
Мошенник	Подтвержденные мошеннические адреса	Fake Airdrop Scammer, Phishing Scam Wallet
Спам	Создатели спам-токенов	Spam Token Creator, Airdrop Spammer

Program categories

Программы (смарт-контракты) классифицируются отдельно:

Категория	Описание	Примеры
Обмен	Протоколы обмена токенов	Jupiter, Raydium, Orca
DeFi	Протоколы DeFi общего назначения	Drift, Mango
Кредитование	Протоколы кредитования	Solend, MarginFi
NFT	Маркетплейсы NFT	Magic Eden, Tensor
Стейкинг	Программы стейкинга	Marinade, Jito
Мост	Межсетевые мосты	Wormhole, AllBridge
Агрегатор	Агрегаторы DEX	Jupiter Aggregator
Бессрочные контракты	Бессрочные фьючерсы	Drift, Mango
Оракул	Поставщики оракулов	Pyth, Switchboard
Лаунчпад	Платформы запуска токенов	Raydium Launchpad
Управление	Программы управления	SPL Governance
Игра или казино	Игровые программы	Star Atlas
Рынок прогнозов	Рынки прогнозов	Drift Predictions
Платежи	Платежные протоколы	Solana Pay
Конфиденциальность	Протоколы конфиденциальности	Elusiv
Сжатие	Сжатие состояния	Bubblegum
Инфраструктура	Основная инфраструктура	Metaplex
Инструменты	Инструменты для разработчиков	Clockwork
RWA	Активы реального мира	Ondo Finance
DePIN	Децентрализованная инфраструктура	Helium, Render
DeSci	Децентрализованная наука	VitaDAO
Аирдроп	Программы аирдропов	Распределители Merkle
Web3	Приложения Web3	Различные
Нативная программа	Нативные программы Solana	System Program
Собственный AMM	Пользовательские реализации AMM	Phoenix
Торговый снайпер	Торговые боты	Боты MEV
Арбитражный или сэндвич-бот	Боты MEV и арбитражные боты	Пакеты Jito
Спам	Спам-программы	Спам-токены
Другое	Программы без категории	Различные

Варианты использования

Пометка пополнений бирж

Определяйте случаи отправки средств на централизованную биржу:

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;
};

Отображение понятных пользователю названий

Показывайте в пользовательском интерфейсе понятные названия вместо адресов:

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"

Пакетная обработка контрагентов транзакций

Эффективно определяйте всех контрагентов в списке транзакций:

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"
  }));
};

Распространенные ошибки

Код ошибки	Описание	Решение
400	Недопустимый формат адреса кошелька или домена либо передача домена не в основной сети	Убедитесь, что входные данные являются допустимым адресом Solana в формате base58 или корректным доменом (например, `toly.sol`), а запрос направляется в основную сеть
401	Ключ API отсутствует или недействителен	Убедитесь, что ключ API включен в запрос
403	Для эндпоинта требуется платный тариф	Поиск идентификационных данных недоступен на бесплатном тарифе. Перейдите на платный тариф
404	Идентификационные данные не найдены или домен не удалось разрешить	Только для эндпоинта одиночного поиска: для кошелька нет идентификационной записи или домен не существует. В пакетных запросах неразрешимые домены возвращаются как записи `unresolved: true`, а не как ошибка 404
429	Превышено ограничение частоты запросов	Уменьшите частоту запросов или перейдите на другой тариф

Дальнейшие действия

Funding Source

Определите, кто изначально пополнил кошелек: типы источников финансирования используют те же категории идентификации.

Wallet API Overview

Все эндпоинты Wallet API и общие соглашения.

API Reference

Схемы запросов и ответов для поиска идентификационных данных.

Начало работы

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

Как определить владельца кошелька Solana

Обзор

Когда использовать

Быстрый старт

Поиск одного кошелька

Поиск по доменному имени

Пакетный поиск (до 100 записей)

Формат ответа

Категории идентификации

Варианты использования

Пометка пополнений бирж

Отображение понятных пользователю названий

Пакетная обработка контрагентов транзакций

Рекомендации

Распространенные ошибки

Дальнейшие действия

Funding Source

Wallet API Overview

API Reference

​Обзор

​Когда использовать

​Быстрый старт

​Поиск одного кошелька

​Поиск по доменному имени

​Пакетный поиск (до 100 записей)

​Формат ответа

​Категории идентификации

​Варианты использования

​Пометка пополнений бирж

​Отображение понятных пользователю названий

​Пакетная обработка контрагентов транзакций

​Рекомендации

​Распространенные ошибки

​Дальнейшие действия

Funding Source

Wallet API Overview

API Reference

Обзор

Когда использовать

Быстрый старт

Поиск одного кошелька

Поиск по доменному имени

Пакетный поиск (до 100 записей)

Формат ответа

Категории идентификации

Варианты использования

Пометка пополнений бирж

Отображение понятных пользователю названий

Пакетная обработка контрагентов транзакций

Рекомендации

Распространенные ошибки

Дальнейшие действия