Skip to main content
Usa identity para etiquetar wallets en listas de holders, feeds y rankings. Una wallet puede tener varias etiquetas; los roles de desarrollador y pool dependen del token consultado.
Las etiquetas de wallet se devuelven a través del objeto identity. Una wallet puede tener varias etiquetas a la vez, así que lee siempre identity.tags como un array en lugar de asumir una sola etiqueta.

​
Inicio rápido

La identidad de wallet aparece en las respuestas de wallet, token, leaderboard y batch de PnL V2 cuando se conoce una etiqueta. Perfil de wallet mostrando etiquetas de identidad junto al nombre del wallet
Si una wallet no tiene etiquetas conocidas, identity puede ser null. identity.type es la etiqueta principal para UIs con una sola insignia. identity.tags es la lista completa de etiquetas y debe usarse cuando necesites todas. En el ejemplo anterior, la wallet está etiquetada como bot conocido. Una UI podría mostrar una insignia de identity.type, mientras que un sistema de filtrado debería leer todos los valores de identity.tags.

​
Señales brutas del wallet

Algunos endpoints de wallet también devuelven un objeto tags bruto con señales de arbitraje y plataforma de menor nivel:
Usa identity.tags para labels de UI y lógica de filtrado. Usa el objeto tags bruto cuando necesites específicamente las señales subyacentes de arbitraje/plataforma.

​
Etiquetas de wallet soportadas

axiom-flash se acepta como valor de consulta de platform, pero las respuestas de identidad lo normalizan a la etiqueta axiom.

​
Categorías de etiquetas

​
Personas y bots

Usa kol, bot, potential_bot y arbitrage para separar traders humanos de comportamientos automatizados o tipo MEV. potential_bot es una señal heurística más suave. bot y arbitrage son labels curados más fuertes.

​
Seguridad e infraestructura

Usa hacker, spam_dusting y exchange para advertencias de seguridad y labels de infraestructura. Estas etiquetas están curadas y también pueden promover un label legible a identity.name, por ejemplo el nombre de un exchange o un label de spam-dusting.

​
Contexto del token

Usa developer y pool en endpoints con scope de token para encontrar creadores de tokens, deployers de pools, mint authorities, cuentas LP, vaults de pool y cuentas de bonding curve. Los endpoints con scope de token resuelven estos roles para el token en la URL, lo que es útil para detectar insiders y wallets no-trader en listas de holders o primeros compradores.

​
Filtros de plataforma

Los endpoints siguientes aceptan platform=axiom, platform=bloom, platform=photon o combinaciones separadas por comas. Leaderboard de Axiom filtrado a wallets que operan a través de Axiom
  • GET /v2/pnl/leaderboard/top
  • GET /v2/pnl/tokens/:token/traders
  • GET /v2/pnl/tokens/:token/first-buyers
También se acepta platform=axiom-flash y se trata como axiom.

​
Dónde aparecen las etiquetas

La identidad del wallet se devuelve en respuestas de wallet, token, leaderboard y batch de PnL V2 cuando la API puede resolver una etiqueta.
  • Resumen y posiciones de wallet devuelven identity a nivel superior.
  • Los endpoints de traders por token devuelven identity por trader.
  • Los endpoints con scope de token resuelven developer y pool para el token en la URL.
  • Los endpoints batch de posición devuelven identity por wallet o posición.
  • POST /v2/pnl/wallets/batch devuelve tanto identity como tags brutos por wallet.

​
Casos de uso comunes

​
FAQ

Sí. Por ejemplo, una wallet puede ser tanto kol como axiom, o developer y pool según el contexto del token. Lee siempre identity.tags como un array.
bot es un label de bot con nombre curado. potential_bot es una señal heurística más suave a partir del comportamiento del wallet. arbitrage es un label de wallet MEV o arbitraje confirmado.
axiom-flash se acepta para filtrado por plataforma, pero las respuestas de identidad normalizan los alias de plataforma para que los clientes solo necesiten manejar la etiqueta canónica axiom.
Usa identity.tags para labels, insignias y filtrado en la mayoría de apps. Usa el objeto tags bruto cuando necesites específicamente isArbitrage o el array original de plataformas.