Skip to main content
La Wallet API está en fase beta. Los endpoints y formatos de respuesta pueden cambiar.

Descripción general

El endpoint Wallet Funding Source identifica quién financió originalmente una billetera de Solana mediante el análisis de su primera transferencia entrante de SOL. Resulta útil para la atribución, el cumplimiento normativo, la comprensión de las relaciones entre billeteras y la identificación de billeteras financiadas por exchanges. El nombre y la categoría del financiador provienen del mismo sistema de identidad que utiliza el endpoint Identity. Por lo tanto, cuando el financiador es una entidad conocida, obtienes una etiqueta legible y una categoría directamente en la respuesta. Este endpoint requiere un plan de pago. Las solicitudes realizadas con una API key del plan Free devuelven 403 Forbidden. Consulta Requisitos del plan para ver la tabla de cobertura completa.

Cuándo usarlo

Usa la API Wallet Funding Source para lo siguiente:
  • Atribución de billeteras: rastrea desde dónde se financian las billeteras nuevas.
  • Detección de exchanges: identifica las billeteras financiadas directamente desde exchanges centralizados.
  • Cumplimiento normativo y AML: marca las billeteras financiadas por entidades conocidas para realizar verificaciones de cumplimiento.
  • Detección de bots: identifica granjas de bots financiadas desde la misma fuente.
  • Análisis de airdrops: rastrea qué billeteras recibieron financiamiento inicial de un proyecto.
  • Detección de Sybil: encuentra grupos de billeteras financiadas por la misma dirección.

Inicio rápido

Consulta básica de financiamiento

Descubre quién financió una billetera:

Formato de respuesta

Una respuesta exitosa describe la primera transferencia entrante de SOL de la billetera:
Si una billetera nunca ha recibido SOL, la API devuelve un error 404:

Notas sobre los campos

  • funder: la dirección que envió la primera transferencia de SOL a esta billetera.
  • funderName: nombre legible si el financiador es una entidad conocida (por ejemplo, un exchange o protocolo); de lo contrario, null.
  • funderType: categoría del financiador (por ejemplo, exchange, defi-protocol); null si no está en la base de datos de identidades.
  • mint: dirección de emisión del token (So11111111111111111111111111111111111111111 para SOL).
  • symbol: símbolo del token (siempre SOL para las transacciones de financiamiento).
  • amount: cantidad inicial de SOL recibida (en formato legible, por ejemplo, 0.05 SOL).
  • amountRaw: cantidad sin procesar en lamports como cadena (por ejemplo, "50000000" para 0.05 SOL).
  • decimals: número de decimales del token (9 para SOL).
  • date: cadena de fecha con formato ISO 8601 (por ejemplo, "2024-01-01T00:00:00.000Z").
  • signature: firma de la transacción de financiamiento.
  • timestamp: marca de tiempo Unix (en segundos) del momento en que se financió la billetera.
  • slot: número de slot de Solana en el que se confirmó la transacción de financiamiento.
  • explorerUrl: enlace directo para ver la transacción en Orb.

Casos de uso

Detectar billeteras financiadas por exchanges

Identifica las billeteras financiadas directamente desde exchanges centralizados:

Encontrar grupos de billeteras (detección de Sybil)

Identifica grupos de billeteras financiadas por la misma fuente:

Rastrear destinatarios de airdrops

Analiza de dónde provienen los destinatarios de airdrops:

Crear una cronología de la billetera

Crea una cronología a partir de la creación de la billetera:

Puntuación de riesgo de cumplimiento

Asigna puntuaciones de riesgo según la fuente de financiamiento:

Seguimiento de atribución

Rastrea qué fuentes crean la mayor cantidad de billeteras nuevas:

Tipos de financiadores

El campo funderType indica la categoría de la billetera que financió la dirección. Se admiten todos los valores de Categorías de identidad.
Tipos de financiadores comunes:La lista completa incluye: Airdrop, Authority, Cross-chain Bridge, Casino & Gambling, DAO, DeFi, DePIN, Centralized Exchange, Exploiter/Hackers/Scams, Fees, Fundraise, Game, Genesis Block Distribution, Governance, Hacker, Jito, Key Opinion Leader, Market Maker, Memecoin, Multisig, NFT, Non-Circulating Supply, Oracle, Other, Payments, Proprietary AMM, Restaking, Rugger, Scammer, Spam, Stake Pool, System, Tools, Trading App/Bot, Trading Firm, Transaction Sending, Treasury, Validator, Vault y X402.Consulta la sección Categorías de identidad para ver la lista completa con descripciones.

Prácticas recomendadas

  • Gestiona las respuestas 404. Las billeteras que nunca han recibido SOL devuelven un error 404. Esto es normal para las billeteras recién creadas que aún no tienen fondos.
  • Combínala con la Identity API. La respuesta incluye funderName e funderType, pero puedes llamar al endpoint Identity con la dirección funder para obtener más detalles.
  • Almacena en caché los datos de financiamiento. La fuente de financiamiento de una billetera nunca cambia. Almacena estos datos permanentemente en caché para evitar llamadas repetidas a la API.
  • Comprueba la antigüedad para obtener contexto. timestamp indica cuándo se financió la billetera por primera vez. Combina la antigüedad con la fuente de financiamiento para obtener más contexto.

Errores comunes

Limitaciones

  • Este endpoint solo rastrea la primera transferencia de SOL a una billetera.
  • Si una billetera se creó mediante un airdrop o la inicialización de un programa sin una transferencia de SOL, no tendrá datos de financiamiento.
  • La fuente de financiamiento representa al financiador inmediato, no necesariamente la fuente original de los fondos.
  • Los datos históricos solo están disponibles para las billeteras creadas después de la implementación de esta función.

Próximos pasos

Wallet Identity

Resuelve la dirección del financiador para obtener una etiqueta completa, una categoría y etiquetas adicionales.

Wallet API Overview

Todos los endpoints de Wallet API y las convenciones compartidas.

API Reference

Esquemas de solicitud y respuesta para consultar la fuente de financiamiento.