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

# Consultar PnL y posiciones de wallets Solana

> Obtén resúmenes de PnL, posiciones, historial diario, gráficos, rendimiento y exposición de wallets Solana.

Consulta el resumen para los resultados totales y las posiciones para ver qué tokens los explican. Usa el historial para cambios diarios y los datos de riesgo para la exposición actual.

## Resumen de wallet

Empieza aquí. El [resumen de wallet](/es/data-api/pnl-v2/wallet/get-wallet-summary) te da la vista de alto nivel: PnL total, win rate, número de tokens operados y distribución del ROI.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";

  const res = await fetch(`https://data.solanatracker.io/v2/pnl/wallets/${wallet}`, {
    headers: { "x-api-key": "YOUR_API_KEY" }
  });
  const data = await res.json();

  console.log(`Total PnL: $${data.summary.pnl.total.toFixed(2)}`);
  console.log(`Win Rate: ${data.analysis.winRate}%`);
  console.log(`Tokens Traded: ${data.summary.counts.tokensTraded}`);
  ```

  ```python Python theme={null}
  import requests

  wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"
  res = requests.get(
      f"https://data.solanatracker.io/v2/pnl/wallets/{wallet}",
      headers={"x-api-key": "YOUR_API_KEY"}
  )
  data = res.json()

  print(f"Total PnL: ${data['summary']['pnl']['total']:.2f}")
  print(f"Win Rate: {data['analysis']['winRate']}%")
  ```
</CodeGroup>

## Posiciones de tokens

El [endpoint de posiciones](/es/data-api/pnl-v2/wallet/get-wallet-positions) lista cada token que ha operado un wallet. Ordena por PnL, ROI o valor. Filtra por estado de holding, mercado, mínimo invertido, etc.

### Modo PnL

Los endpoints de resumen, posiciones y posición individual soportan `?pnlMode=strict|adjusted|raw`. El valor por defecto es `strict`, que filtra las posiciones donde la cantidad vendida supera a la comprada (normalmente inválidas). Cambia a `adjusted` para una vista con cost basis corregido, o `raw` para verlo todo sin filtrar. Detalles en los [Esenciales](/es/guides/pnl-v2/overview#essentials).

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions?pnlMode=adjusted" \
  -H "x-api-key: YOUR_API_KEY"
```

### Filtros comunes

<AccordionGroup>
  <Accordion title="Mostrar solo posiciones rentables">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?filter=profit&sort=total&direction=desc
    ```
  </Accordion>

  <Accordion title="Mostrar tokens en cartera actualmente">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?filter=holding&sort=value&direction=desc
    ```
  </Accordion>

  <Accordion title="Filtrar por inversión mínima">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?minInvested=100&sort=roi&direction=desc
    ```
  </Accordion>

  <Accordion title="Filtrar por mercado específico (p. ej. pump.fun)">
    ```bash theme={null}
    GET /v2/pnl/wallets/{wallet}/positions?market=pumpfun&sort=total&direction=desc
    ```
  </Accordion>
</AccordionGroup>

### Posición individual

Para profundizar en un token, usa el endpoint de [posición de token del wallet](/es/data-api/pnl-v2/wallet/get-wallet-token-position):

```bash theme={null}
GET /v2/pnl/wallets/{wallet}/tokens/{token}
```

Devuelve la posición completa: PnL realizado/no realizado, cost basis, valor actual, conteos de compras/ventas, timing de operaciones y metadatos del token.

## Calendario de PnL

El [endpoint de calendario de PnL](/es/data-api/pnl-v2/wallet/get-wallet-pnl-calendar) muestra cómo cambió el PnL del wallet día a día.

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-calendar.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=32e956ede9e011871af7d0e29df564b2" alt="Calendario de PnL mostrando celdas verdes y rojas de ganancia y pérdida diarias" width="1038" height="1292" data-path="images/guides/pnl-calendar.png" />

<CodeGroup>
  ```bash Últimos 30 días theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?period=30d" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```bash Rango de fechas personalizado theme={null}
  curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/history?start=2025-01-01&end=2025-01-31" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

Cada día incluye:

* **Totales acumulados** — PnL, invertido y proceeds a la fecha
* **Actividad diaria** — PnL realizado, volumen y conteos de operaciones de ese día

<Tip>
  Usa **history** cuando necesites explicar qué cambió cada día. Usa **chart** cuando necesites una curva de equity visual.
</Tip>

## Datos del gráfico

El [endpoint de chart](/es/data-api/pnl-v2/wallet/get-wallet-chart) devuelve hasta 180 puntos de datos diarios para trazar equity, PnL realizado y actividad.

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-chart.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=9a2eb20d19fc7bfada16fb86785be20d" alt="Gráfico de PnL mostrando beneficio realizado a lo largo del tiempo, volumen, win rate y drawdown" width="2690" height="1010" data-path="images/guides/pnl-chart.png" />

```javascript theme={null}
const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";

const res = await fetch(`https://data.solanatracker.io/v2/pnl/wallets/${wallet}/chart`, {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const { points, summary } = await res.json();

// points is an array of daily chart rows
// summary contains streaks, drawdown, and win-rate style aggregates
console.log(points.length, summary.winRate);
```

Usa `time_from` y `time_to` (segundos Unix) para paginar datos antiguos.

## Rendimiento

El [endpoint de performance](/es/data-api/pnl-v2/wallet/get-wallet-performance) te da estadísticas en ventana móvil:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-performance.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=7c9b39de2ea2c7c6e4cd5436251cbcfc" alt="Panel de rendimiento del wallet mostrando mejor día, peor día, rachas y drawdown" width="2534" height="728" data-path="images/guides/pnl-performance.png" />

| Métrica | Descripción |
| - | - |
| PnL realizado total | Suma del PnL realizado en la ventana |
| Rachas ganadoras/perdedoras | Días consecutivos ganadores/perdedores actuales y máximos |
| Drawdown máximo | Mayor caída del valor más alto al punto más bajo |
| Mejor/peor día | El mejor y el peor día de trading |
| Desglose diario | PnL, volumen y conteos de operaciones día a día |

```bash theme={null}
# Rendimiento de los últimos 90 días
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/performance?days=90" \
  -H "x-api-key: YOUR_API_KEY"
```

## Highlights

El [endpoint de highlights](/es/data-api/pnl-v2/wallet/get-wallet-highlights) devuelve las posiciones más destacadas de un wallet:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-highlights.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=b2ffc5854ac6d0ebb5e8aadfef3d7772" alt="Panel de highlights de PnL mostrando mayor ganador, perdedor, bag y flip más rápido" width="2536" height="538" data-path="images/guides/pnl-highlights.png" />

<CardGroup cols={2}>
  <Card title="Mayor ganador">
    La posición con mayor PnL realizado
  </Card>

  <Card title="Mayor perdedor">
    La posición con la peor pérdida realizada
  </Card>

  <Card title="Flip más rápido">
    Menor tiempo de tenencia con beneficio
  </Card>

  <Card title="Tenencia más larga">
    La posición mantenida durante más tiempo
  </Card>

  <Card title="Bag más grande">
    Holding actual con mayor valor en USD
  </Card>

  <Card title="Más operado">
    El token con más transacciones de compra/venta
  </Card>
</CardGroup>

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/highlights" \
  -H "x-api-key: YOUR_API_KEY"
```

## Riesgo

El [endpoint de riesgo](/es/data-api/pnl-v2/wallet/get-wallet-risk) evalúa la exposición actual del portfolio:

<img src="https://mintcdn.com/solanatracker/ZM5vWoSAJUJFeh6A/images/guides/pnl-exposure.png?fit=max&auto=format&n=ZM5vWoSAJUJFeh6A&q=85&s=921b7de365bb379afcdecd660f80c235" alt="Panel de exposición del wallet mostrando posiciones abiertas, cost basis, valor actual y mezcla de PnL" width="2526" height="756" data-path="images/guides/pnl-exposure.png" />

* **Concentración del portfolio** — cuánto hay en la top 1 y top 5 posiciones
* **Mezcla realizado vs no realizado** — ¿el wallet tiene ganancias en papel o beneficios asegurados?
* **Valor de posiciones abiertas** — valor total en USD de las tenencias actuales
* **Holdings de riesgo** — lista de tokens con liquidez baja o riesgo de concentración alto

```bash theme={null}
curl "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/risk" \
  -H "x-api-key: YOUR_API_KEY"
```

<Warning>
  Risk solo cubre **holdings actuales**. Las posiciones vendidas no se incluyen.
</Warning>

## Actualizaciones en vivo

Mantén un wallet sincronizado con las salas Datastream PnL V2 en lugar de hacer polling:

* `pnl:{wallet}:summary` — resumen total del PnL del wallet con PnL realizado/no realizado, ROI, conteos, medias y totales de posiciones abiertas.
* `pnl:{wallet}` — cada token que el wallet toca, `tradeUpdate` / `balanceUpdate`.
* `pnl:{wallet}:{token}` — una posición individual.

Siembra tu UI con `GET /v2/pnl/wallets/:wallet`, luego suscríbete a la sala summary. Consulta la [guía Datastream PnL](/es/guides/datastream-pnl) para los payloads completos.

<CardGroup cols={2}>
  <Card title="Traders del token" href="/es/guides/pnl-v2/token-intelligence">
    Mira cómo se operó un token específico entre wallets.
  </Card>

  <Card title="Referencia de la API" href="/es/data-api/pnl-v2/wallet/get-wallet-summary">
    Detalles completos del esquema para la respuesta de resumen de wallet.
  </Card>
</CardGroup>


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