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 devuelven403 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:- JavaScript
- Python
- cURL
Formato de respuesta
Una respuesta exitosa describe la primera transferencia entrante de SOL de la billetera: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);nullsi no está en la base de datos de identidades.mint: dirección de emisión del token (So11111111111111111111111111111111111111111para SOL).symbol: símbolo del token (siempreSOLpara las transacciones de financiamiento).amount: cantidad inicial de SOL recibida (en formato legible, por ejemplo,0.05SOL).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 campofunderType indica la categoría de la billetera que financió la dirección. Se admiten todos los valores de Categorías de identidad.
Supported funder types
Supported funder types
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
funderNameefunderType, pero puedes llamar al endpoint Identity con la direcciónfunderpara 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.
timestampindica 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.