Consultar PnL de wallets y tokens por lotes

Agrupa direcciones y mints conocidos para reducir peticiones. Los lotes de posiciones devuelven filas por token; los de resúmenes, totales e identidad.

Cuándo usar endpoints batch

Los endpoints batch están diseñados para escenarios en los que necesitas datos de posición de varias entidades a la vez:

Tracker de portfolio

Recupera las posiciones de un wallet en más de 50 tokens en una sola llamada

Dashboard de token

Obtén cómo rindieron 200 wallets en un token concreto

Enriquecimiento de leaderboard

Consulta pares wallet+token específicos a partir de resultados de leaderboard

Hay dos tipos de endpoints batch:

Batch de posiciones devuelve filas de posición a nivel de token y soporta pnlMode.
Batch de resumen de wallets devuelve resúmenes a nivel de wallet y etiquetas, hasta 100 wallets. No acepta pnlMode.

Un wallet, muchos tokens

Usa wallet batch positions cuando tienes un wallet y quieres comprobar varios tokens a la vez.

curl -X POST "https://data.solanatracker.io/v2/pnl/wallets/{wallet}/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokens": [
      "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
      "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump",
      "CMx7yon2cLzHcXqgHsKJhuU3MmME6noWLQk2rAycBAGS"
    ]
  }'

const wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o";
const tokens = [
  "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
  "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
];

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/wallets/${wallet}/positions/batch`,
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ tokens })
  }
);
const { positions, notFound } = await res.json();

positions.forEach(p => {
  console.log(`${p.meta.symbol}: $${p.pnl.total.toFixed(2)} PnL`);
});
if (notFound.length) {
  console.log(`Not traded: ${notFound.join(", ")}`);
}

import requests

wallet = "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o"
tokens = [
    "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
    "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
]

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

for p in data["positions"]:
    print(f"{p['meta']['symbol']}: ${p['pnl']['total']:.2f}")

Límite: 100 tokens por solicitud. Los tokens que la wallet nunca ha operado aparecen en el array notFound. Los faltantes se listan allí; no son errores de solicitud.

Muchos resúmenes de wallets

Usa POST /v2/pnl/wallets/batch cuando solo necesites resúmenes a nivel de wallet y etiquetas, no posiciones por token. La solicitud acepta hasta 100 direcciones únicas. Las direcciones inválidas se devuelven en invalid, las wallets sin resumen de PnL se devuelven en notFound, y las solicitudes con más de 100 wallets únicas válidas incluyen un objeto truncated.

curl -X POST "https://data.solanatracker.io/v2/pnl/wallets/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
    ]
  }'

Cada wallet devuelta refleja la forma del resumen de wallet: wallet, identity, summary, tags y updatedAt.

Un token, muchas wallets

Usa token batch positions para comparar cómo rindieron varias wallets en el mismo token.

curl -X POST "https://data.solanatracker.io/v2/pnl/tokens/{token}/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
      "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
    ]
  }'

const token = "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump";
const wallets = [
  "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
  "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"
];

const res = await fetch(
  `https://data.solanatracker.io/v2/pnl/tokens/${token}/positions/batch`,
  {
    method: "POST",
    headers: {
      "x-api-key": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ wallets })
  }
);
const { positions, notFound } = await res.json();

positions.forEach(p => {
  console.log(`${p.wallet}: $${p.pnl.token.total.toFixed(2)} on this token, ${p.counts.total} trades`);
});

Límite: 200 wallets por solicitud.

Pares wallet-token arbitrarios

Use position batch lookup for a list of wallet-token pairs.

curl -X POST "https://data.solanatracker.io/v2/pnl/positions/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pairs": [
      {
        "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
        "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump"
      },
      {
        "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
        "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump"
      }
    ]
  }'

const pairs = [
  { wallet: "CyaE1...", token: "38Pgz..." },
  { wallet: "CyaE1...", token: "84cAE..." },
  { wallet: "vines...", token: "38Pgz..." }
];

const res = await fetch("https://data.solanatracker.io/v2/pnl/positions/batch", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ pairs })
});
const { positions, notFound } = await res.json();

console.log(`Found ${positions.length} positions, ${notFound.length} not found`);

Límite: 200 pares por solicitud.

Qué endpoint usar

Lo que quieres…	Endpoint	Límite
PnL de un wallet en 50 tokens	Wallet batch	100 tokens
PnL de 100 wallets en un token	Token batch	200 wallets
Combos wallet+token específicos	Pair batch	200 pares
Resúmenes de wallet y etiquetas	`POST /v2/pnl/wallets/batch`	100 wallets

Los inputs no encontrados vuelven en un array notFound en lugar de causar errores. Compruébalo siempre.

Modo PnL

Los tres endpoints batch de posiciones aceptan ?pnlMode=strict|adjusted|raw como parámetro de consulta. Por defecto es strict. El endpoint batch de resumen de wallets no acepta pnlMode. Consulta los Esenciales para ver qué hace cada modo.

curl -X POST "https://data.solanatracker.io/v2/pnl/positions/batch?pnlMode=adjusted" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pairs": [ ... ] }'

Rankings de traders

Construye una preselección de wallets para enriquecer por lotes.

PnL de la wallet

Profundiza en una wallet a partir de tus resultados batch.

Primeros pasos

Datos de tokens

Wallets y PnL

Datos en vivo

Pump.fun

Mercados de predicción

Swaps y RPC

Consultar PnL de wallets y tokens por lotes

Cuándo usar endpoints batch

Tracker de portfolio

Dashboard de token

Enriquecimiento de leaderboard

Un wallet, muchos tokens

Muchos resúmenes de wallets

Un token, muchas wallets

Pares wallet-token arbitrarios

Qué endpoint usar

Modo PnL

Rankings de traders

PnL de la wallet

​Cuándo usar endpoints batch

Tracker de portfolio

Dashboard de token

Enriquecimiento de leaderboard

​Un wallet, muchos tokens

​Muchos resúmenes de wallets

​Un token, muchas wallets

​Pares wallet-token arbitrarios

​Qué endpoint usar

​Modo PnL

Rankings de traders

PnL de la wallet

Cuándo usar endpoints batch

Un wallet, muchos tokens

Muchos resúmenes de wallets

Un token, muchas wallets

Pares wallet-token arbitrarios

Qué endpoint usar

Modo PnL