Wallet API находится на стадии бета-тестирования. Конечные точки и форматы ответов могут измениться.
Обзор
Конечная точка Wallet Funding Source определяет, кто первоначально профинансировал кошелёк Solana, анализируя его первый входящий перевод SOL. Она полезна для установления принадлежности, соблюдения нормативных требований, анализа связей между кошельками и выявления кошельков, профинансированных с бирж. Имя и категория отправителя средств берутся из той же системы идентификации, которую использует конечная точка Identity. Поэтому, если отправитель является известной организацией, в ответе сразу будут указаны понятные человеку метка и категория. Для этой конечной точки требуется платный тариф. Запросы с ключом API бесплатного тарифа возвращают403 Forbidden. Полная таблица доступности приведена в разделе Требования к тарифам.
Когда использовать
Используйте Wallet Funding Source API для следующих задач:- Установление принадлежности кошельков: отслеживайте источники финансирования новых кошельков.
- Обнаружение бирж: выявляйте кошельки, профинансированные непосредственно с централизованных бирж.
- Соблюдение нормативных требований и AML: отмечайте для проверки кошельки, профинансированные известными организациями.
- Обнаружение ботов: выявляйте фермы ботов, профинансированные из одного источника.
- Анализ аирдропов: отслеживайте кошельки, которые получили первоначальное финансирование от проекта.
- Обнаружение атак Сивиллы: находите группы кошельков, профинансированных с одного адреса.
Быстрый старт
Базовый поиск источника финансирования
Узнайте, кто профинансировал кошелёк:- JavaScript
- Python
- cURL
Формат ответа
Успешный ответ содержит сведения о первом входящем переводе SOL на кошелёк:Примечания к полям
funder: адрес, с которого на этот кошелёк был отправлен первый перевод SOL.funderName: понятное человеку имя, если отправитель средств является известной организацией (например, биржей или протоколом); в противном случае —null.funderType: категория отправителя средств (например,exchange,defi-protocol);null, если отправителя нет в базе данных идентификации.mint: адрес выпуска токена (So11111111111111111111111111111111111111111для SOL).symbol: символ токена (всегдаSOLдля транзакций финансирования).amount: первоначально полученная сумма SOL в удобочитаемом формате (например,0.05SOL).amountRaw: исходная сумма в лампортах в виде строки (например,"50000000"для 0,05 SOL).decimals: количество знаков после запятой для токена (9 для SOL).date: строка даты в формате ISO 8601 (например,"2024-01-01T00:00:00.000Z").signature: подпись транзакции перевода финансирования.timestamp: временная метка Unix (в секундах), указывающая, когда кошелёк был профинансирован.slot: номер слота Solana, в котором была подтверждена транзакция финансирования.explorerUrl: прямая ссылка на просмотр транзакции в Orb.
Сценарии использования
Обнаружение кошельков, профинансированных с бирж
Выявляйте кошельки, профинансированные непосредственно с централизованных бирж:Поиск групп кошельков (обнаружение атак Сивиллы)
Выявляйте группы кошельков, профинансированных из одного источника:Отслеживание получателей аирдропа
Анализируйте происхождение получателей аирдропа:Создание хронологии кошелька
Создайте хронологию, начиная с момента создания кошелька:Оценка комплаенс-риска
Назначайте оценки риска на основе источника финансирования:Отслеживание принадлежности
Отслеживайте источники, из которых создаётся больше всего новых кошельков:Типы отправителей средств
ПолеfunderType указывает категорию кошелька, с которого был профинансирован адрес. Поддерживаются все значения из раздела Категории Identity.
Supported funder types
Supported funder types
Распространённые типы отправителей средств:
Полный список включает следующие категории: аирдроп, уполномоченный адрес, межсетевой мост, казино и азартные игры, DAO, DeFi, DePIN, централизованная биржа, эксплойтеры/хакеры/мошенники, комиссии, сбор средств, игра, распределение генезис-блока, управление, хакер, Jito, лидер общественного мнения, маркетмейкер, мемкоин, мультиподпись, NFT, невыпущенное предложение, оракул, другое, платежи, проприетарный AMM, рестейкинг, организатор рагпула, мошенник, спам, стейкинг-пул, система, инструменты, торговое приложение/бот, торговая компания, отправка транзакций, казначейство, валидатор, хранилище и X402.Полный список с описаниями приведён в разделе Категории Identity.
Рекомендации
- Обрабатывайте ответы 404. Кошельки, которые никогда не получали SOL, возвращают ошибку 404. Это ожидаемое поведение для недавно созданных, но ещё не профинансированных кошельков.
- Используйте вместе с Identity API. Ответ содержит
funderNameиfunderType, но для получения дополнительных сведений можно вызвать конечную точку Identity для адресаfunder. - Кешируйте данные о финансировании. Источник финансирования кошелька никогда не меняется. Храните эти данные в кеше без ограничения срока, чтобы избежать повторных вызовов API.
- Учитывайте возраст кошелька. Поле
timestampуказывает, когда кошелёк впервые был профинансирован. Учитывайте возраст вместе с источником финансирования, чтобы получить более полную картину.
Распространённые ошибки
Ограничения
- Эта конечная точка отслеживает только первый перевод SOL на кошелёк.
- Если кошелёк был создан через аирдроп или инициализацию программы без перевода SOL, данные о финансировании будут отсутствовать.
- Источник финансирования обозначает непосредственного отправителя средств, который не обязательно является первоначальным источником средств.
- Исторические данные доступны только для кошельков, созданных после развёртывания этой функции.
Дальнейшие действия
Wallet Identity
Получите для адреса отправителя средств полную метку, категорию и теги.
Wallet API Overview
Все конечные точки Wallet API и общие соглашения.
API Reference
Схемы запросов и ответов для поиска источника финансирования.