Skip to main content
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 retornam 403 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:

Formato da resposta

Uma resposta bem-sucedida descreve a primeira transferência de SOL recebida pela carteira:
Se uma carteira nunca tiver recebido SOL, a API retorna um 404:

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); null caso contrário.
  • funderType: categoria do financiador (por exemplo, exchange, defi-protocol); null se não estiver no banco de dados de identidade.
  • mint: endereço de cunhagem do token (So11111111111111111111111111111111111111111 para SOL).
  • symbol: símbolo do token (sempre SOL para transações de financiamento).
  • amount: quantidade inicial de SOL recebida (legível por humanos, por exemplo, 0.05 SOL).
  • 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 campo funderType indica a categoria da carteira que financiou o endereço. Todos os valores das Categorias de Identidade são 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 funderName e funderType, mas você pode chamar o endpoint Identity no endereço funder para 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 timestamp indica 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.