A Wallet API está em Beta. Os endpoints e formatos de resposta podem mudar.
Visão Geral
O endpoint Fonte de Financiamento da Carteira identifica quem originalmente financiou uma carteira Solana analisando sua primeira transferência de SOL recebida. É valioso para atribuição, conformidade, compreensão de relações de carteiras e identificação de carteiras financiadas por exchanges. O nome e a categoria do financiador vêm do mesmo sistema de identidade usado pelo endpoint Identity, portanto, quando o financiador é uma entidade conhecida, você obtém um rótulo legível por humanos e categoria diretamente na resposta. Este endpoint requer um plano pago. Solicitações feitas com uma chave de API do plano gratuito retornam403 Forbidden. Consulte Requisitos do plano para a tabela completa de cobertura.
Quando utilizar
Use a Wallet Funding Source API para:- Atribuição de carteiras: rastreie de onde novas carteiras estão sendo financiadas.
- Detecção de exchanges: identifique carteiras financiadas diretamente por exchanges centralizadas.
- Conformidade e AML: sinalize carteiras financiadas por entidades conhecidas para verificações de conformidade.
- Detecção de bots: identifique fazendas de bots financiadas pela mesma fonte.
- Análise de airdrop: rastreie quais carteiras receberam financiamento inicial de um projeto.
- Detecção de Sybil: encontre clusters de carteiras financiadas pelo mesmo endereço.
Início rápido
Consulta básica de financiamento
Descubra quem financiou uma carteira:- JavaScript
- Python
- cURL
Formato da resposta
Uma resposta bem-sucedida descreve a primeira transferência de SOL recebida pela carteira:Notas sobre os campos
funder: o endereço que enviou a primeira transferência de SOL para esta carteira.funderName: nome legível por humanos se o financiador for uma entidade conhecida (por exemplo, exchange, protocolo);nullcaso contrário.funderType: categoria do financiador (por exemplo,exchange,defi-protocol);nullse não estiver no banco de dados de identidade.mint: endereço de cunhagem do token (So11111111111111111111111111111111111111111para SOL).symbol: símbolo do token (sempreSOLpara transações de financiamento).amount: quantidade inicial de SOL recebida (legível por humanos, por exemplo,0.05SOL).amountRaw: quantidade bruta em lamports como string (por exemplo,"50000000"para 0.05 SOL).decimals: número de casas decimais para o token (9 para SOL).date: string de data formatada em ISO 8601 (por exemplo,"2024-01-01T00:00:00.000Z").signature: assinatura da transação de financiamento.timestamp: timestamp Unix (em segundos) quando a carteira foi financiada.slot: número do slot Solana quando a transação de financiamento foi confirmada.explorerUrl: link direto para visualizar a transação no Orb.
Casos de uso
Detectar carteiras financiadas por exchanges
Identifique carteiras financiadas diretamente por exchanges centralizadas:Encontrar clusters de carteiras (Detecção de Sybil)
Identifique grupos de carteiras financiadas pela mesma fonte:Rastrear destinatários de airdrop
Analise de onde vieram os destinatários de airdrop:Construir uma linha do tempo da carteira
Crie uma linha do tempo a partir da criação da carteira:Avaliação de risco de conformidade
Atribua pontuações de risco com base na fonte de financiamento:Rastreamento de atribuição
Acompanhe quais fontes estão criando mais novas carteiras:Tipos de financiadores
O campofunderType indica a categoria da carteira que financiou o endereço. Todos os valores das Categorias de Identidade são suportados.
Tipos de financiadores suportados
Tipos de financiadores suportados
Tipos comuns de financiadores:
A lista completa inclui: Airdrop, Autoridade, Ponte Cross-chain, Cassino & Jogos de Azar, DAO, DeFi, DePIN, Exchange Centralizada, Explorador/Hackers/Golpes, Taxas, Arrecadação de Fundos, Jogo, Distribuição do Bloco Gênesis, Governança, Hacker, Jito, Líder de Opinião, Formador de Mercado, Memecoin, Multisig, NFT, Oferta Não Circulante, Oráculo, Outro, Pagamentos, AMM Proprietário, Restaking, Enganador, Picareta, Spam, Pool de Stake, Sistema, Ferramentas, App/Bot de Trading, Empresa de Trading, Envio de Transações, Tesouraria, Validador, Cofre e X402.Veja a seção Categorias de Identidade para a lista completa com descrições.
Melhores práticas
- Lide com respostas 404. Carteiras que nunca receberam SOL retornam um 404. Isso é esperado para carteiras recém-criadas, mas não financiadas.
- Combine com a Identity API. A resposta inclui
funderNameefunderType, mas você pode chamar o endpoint Identity no endereçofunderpara mais detalhes. - Cache de dados de financiamento. A fonte de financiamento de uma carteira nunca muda. Armazene esses dados permanentemente para evitar chamadas repetidas à API.
- Verifique a idade para contexto. O
timestampindica quando a carteira foi financiada pela primeira vez. Combine a idade com a fonte de financiamento para um melhor contexto.
Erros comuns
Limitações
- Este endpoint rastreia apenas a primeira transferência de SOL para uma carteira.
- Se uma carteira foi criada via airdrop ou inicialização de programa sem uma transferência de SOL, não terá dados de financiamento.
- A fonte de financiamento representa o financiador imediato, não necessariamente a fonte final dos fundos.
- Dados históricos estão disponíveis apenas para carteiras criadas após o lançamento deste recurso.
Próximos passos
Identidade da Carteira
Resolva o endereço do financiador para um rótulo completo, categoria e tags.
Visão Geral da Wallet API
Todos os endpoints da Wallet API e convenções compartilhadas.
Referência da API
Esquemas de solicitação e resposta para consulta de fonte de financiamento.