> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Identificar wallets Solana con etiquetas

> Lee etiquetas de KOLs, bots, exchanges, desarrolladores, pools y plataformas. Gestiona varias etiquetas e identidades desconocidas.

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.

<Info>
  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.
</Info>

## 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.

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/wallet-tags.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=01ede7436f795c1f3e4887d29d4226e1" alt="Perfil de wallet mostrando etiquetas de identidad junto al nombre del wallet" width="2542" height="832" data-path="images/guides/wallet-tags.png" />

```json theme={null}
{
  "identity": {
    "name": "Mayhem Bot",
    "avatar": "https://kol-avatar.solanatracker.io/...",
    "bot": {
      "name": "Mayhem Bot",
      "avatar": "https://kol-avatar.solanatracker.io/..."
    },
    "type": "bot",
    "tags": ["bot"]
  }
}
```

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:

```json theme={null}
{
  "tags": {
    "isArbitrage": false,
    "platforms": ["axiom", "bloom"]
  }
}
```

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

| Etiqueta | Significado | Campos extra |
| - | - | - |
| `kol` | Wallet de KOL monitorizada. | `name`, `twitter`, `avatar` |
| `bot` | Wallet bot con nombre curada, como Mayhem Bot u otros traders automatizados conocidos. | `bot.name`, `bot.avatar` |
| `potential_bot` | Señal heurística de bot / arbitraje a partir de la actividad del wallet. Señal más suave que `bot` o `arbitrage`. | ninguno |
| `arbitrage` | Wallet de MEV / arbitraje confirmada en la lista curada. | ninguno |
| `hacker` | Label curado de exploit, estafa o wallet atacante. | `hacker.label`, a menudo promovido a `name` |
| `spam_dusting` | Label curado de wallet de spam-dusting. | `spamDusting.label`, a menudo promovido a `name` |
| `exchange` | Hot wallet conocida de un exchange centralizado. | `exchange.name`, a menudo promovido a `name` |
| `developer` | Creador de token, deployer de pool, mint authority o wallet ligada a la creación de un token. | `developer.token`, `developer.via`, `developer.pools`, `developer.creationTx`, `developer.createdAt` o `developer.tokens` |
| `pool` | Pool AMM, vault, authority, LP mint, bonding curve o cuenta relacionada con un pool. | `pool.program`, `pool.poolAddress`, `pool.tokenA`, `pool.tokenB` |
| `axiom` | Actividad de wallet asociada con Axiom. | `platforms` incluye `axiom` |
| `bloom` | Actividad de wallet asociada con Bloom. | `platforms` incluye `bloom` |
| `photon` | Actividad de wallet asociada con Photon. | `platforms` incluye `photon` |

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

## 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.

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/axiom-leaderboard.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=f6ef49ec2b3ad1894f68873a420f1a91" alt="Leaderboard de Axiom filtrado a wallets que operan a través de Axiom" width="2596" height="2138" data-path="images/guides/axiom-leaderboard.png" />

* `GET /v2/pnl/leaderboard/top`
* `GET /v2/pnl/tokens/:token/traders`
* `GET /v2/pnl/tokens/:token/first-buyers`

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/tokens/{token}/traders?platform=axiom,bloom" \
  -H "x-api-key: YOUR_API_KEY"
```

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

| Objetivo | Etiquetas a comprobar |
| - | - |
| Ocultar wallets ruidosas | `bot`, `potential_bot`, `arbitrage`, `spam_dusting` |
| Mostrar personas conocidas | `kol` |
| Marcar insiders del token | `developer`, `pool` |
| Mostrar advertencias de seguridad | `hacker`, `spam_dusting` |
| Identificar flujos de exchange | `exchange` |
| Filtrar por frontend de trading | `axiom`, `bloom`, `photon` |

## FAQ

<AccordionGroup>
  <Accordion title="¿Puede una wallet tener varias etiquetas?">
    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.
  </Accordion>

  <Accordion title="¿Cuál es la diferencia entre bot, potential_bot y arbitrage?">
    `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.
  </Accordion>

  <Accordion title="¿Por qué axiom-flash se convierte en axiom?">
    `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`.
  </Accordion>

  <Accordion title="¿Debo usar identity.tags o el objeto tags bruto?">
    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.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.