> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Inicio rápido de Eventos analizados
> Analiza tu primera transacción, obtén el historial analizado de una dirección y recorre los resultados por páginas. Además, consulta la referencia REST de ambos endpoints.
¿Es tu primera vez con Eventos analizados? Lee primero el [modelo mental](/docs/es/parsed-streams#el-modelo-mental) de Flujos analizados. Eventos analizados devuelve las mismas instrucciones decodificadas mediante REST y GraphQL.
## Inicio rápido
Eventos analizados está en beta abierta y disponible en los planes de pago. Obtén tu clave de API en el [panel de Helius](https://dashboard.helius.dev) y envía solicitudes a `https://mainnet.helius-rpc.com`.
Autentícate con la clave de API de tu proyecto, que debes pasar como parámetro de consulta `api-key`.
Pasa las firmas en el campo `transactions` del cuerpo de `POST /v1/parsed-events/transactions`:
```javascript theme={"system"}
const parseTransactions = async () => {
const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
transactions: [
"5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
],
includeRawTransaction: false,
}),
});
const data = await response.json();
console.log(data);
};
parseTransactions();
```
```bash theme={"system"}
curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transactions?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"transactions": [
"5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
],
"includeRawTransaction": false
}'
```
La respuesta contiene un resultado por cada firma solicitada, en el orden de entrada. Cada resultado incluye `signature`, `parserStatus` y `parsed` o `parserError`:
```json [expandable] theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "OK",
"parsed": {
"slot": 433950192,
"blockTime": 1784487060,
"fee": 2005000,
"feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"transactionStatus": "OK",
"nativeTransfers": [
{
"fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"toUserAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
"amount": 1500000000000
}
],
"tokenTransfers": [
{
"fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"toUserAccount": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"fromTokenAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
"toTokenAccount": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"rawTokenAmount": 1498500000000,
"decimals": 9,
"tokenStandard": "Fungible",
"mint": "So11111111111111111111111111111111111111112"
}
],
"summary": {
"type": "swap",
"description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
"parsedData": {
"type": "swap",
"protocol": "jupiter",
"kind": "swap",
"in_amount": "1500000000000",
"actual_out_amount": "64672839261950",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"inner_swaps": [
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "470229300000",
"output_amount": "35579021038",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "1028270700000",
"output_amount": "77798063361",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "14625643887",
"output_amount": "8348494812168",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "35566391375",
"output_amount": "20283004384731",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "63185049137",
"output_amount": "36041340065051",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
}
]
}
},
"instructions": [
{
"instructionIndex": 5,
"innerInstructionIndex": 2,
"stackHeight": 3,
"programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"rawAccounts": [
"2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE"
],
"rawData": "3JvpRSxKFyKV",
"summary": {
"type": "transfer",
"description": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE transferred 470.2293 SOL from 7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE to 8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
"parsedData": null
},
"programName": "token",
"instructionName": "transfer",
"decoded": {
"args": {
"amount": "470229300000"
},
"accounts": [
{
"name": "source_account",
"pubkey": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"isSigner": false,
"isWritable": true
},
{
"name": "destination_account",
"pubkey": "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"isSigner": false,
"isWritable": true
},
{
"name": "owner_or_delegate",
"pubkey": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"isSigner": true,
"isWritable": false
}
]
}
},
{
"instructionIndex": 5,
"innerInstructionIndex": 1,
"stackHeight": 2,
"programId": "BiSoNHVpsVZW2F7rx2eQ59yQwKxzU5NvBcmKshCSUypi",
"rawAccounts": [
"7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
"ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
"2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"EpdaePzdqRkMtdZJquVPUWgyoJ5YEEpYALki6dv9VBrt",
"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"Sysvar1nstructions1111111111111111111111111",
"J1to1yufRnoWn81KYg1XkTWzmKjnYSnmE2VY8DGUJ9Qv"
],
"rawData": "67t827t7UwAMHa6U18HnBBLj",
"summary": null,
"programName": "bison_fi",
"instructionName": null,
"decoded": null
}
]
}
}
]
```
El ejemplo se redujo a dos instrucciones: una transferencia de tokens decodificada dentro de la ruta y una instrucción de AMM cuyo programa está registrado en el catálogo, pero no se puede decodificar. Por eso, `instructionName` queda como `null`, mientras que `rawData` e `rawAccounts` siguen disponibles. Consulta la [Respuesta analizada](/docs/es/parsed-events/parsed-response) para conocer todos los campos y ver un ejemplo de respuesta completo.
`POST /v1/parsed-events/transaction-history` devuelve los mismos resultados analizados que se muestran arriba para cada transacción que involucró una dirección. De forma predeterminada, muestra primero las más recientes:
```javascript theme={"system"}
const fetchTransactionHistory = async () => {
const url = "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
address: "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
limit: 100,
sortOrder: "desc",
commitment: "confirmed",
}),
});
const page = await response.json();
console.log(page.data);
console.log(page.paginationToken);
};
fetchTransactionHistory();
```
```bash theme={"system"}
curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"limit": 100,
"sortOrder": "desc",
"commitment": "confirmed"
}'
```
Las respuestas del historial agrupan los resultados en un objeto de página. Vuelve a pasar `paginationToken` en la siguiente solicitud para continuar. Si falta `paginationToken`, el servicio llegó al final del intervalo de páginas disponible.
## Guías
Recorre por páginas todos los tokens que una billetera implementó en Pump.fun.
Selecciona exactamente los campos analizados que necesita tu aplicación.
Asignación de endpoints, parámetros y respuestas desde la API heredada.
## Referencia REST
Ambos métodos REST aceptan un cuerpo JSON mediante `POST` bajo `/v1/parsed-events/` en `https://mainnet.helius-rpc.com` y se autentican con el parámetro de consulta `api-key`. Los cuerpos de las solicitudes rechazan los campos desconocidos. Así, los errores tipográficos generan un error visible en lugar de ignorarse silenciosamente. Las consultas GraphQL se envían a `POST /v1/parsed-events/graphql`.
### Analizar transacciones
`POST /v1/parsed-events/transactions` obtiene transacciones completas de Solana por firma, las decodifica con el mismo decodificador de instrucciones basado en IDL que utiliza [Flujos analizados](/docs/es/parsed-streams) y devuelve un `TransactionResult` por cada firma solicitada. El mismo método está disponible en GraphQL como `transactions`.
El orden de la respuesta coincide con el orden de entrada, incluidas las firmas duplicadas. Las transacciones faltantes y los errores del analizador de elementos individuales se devuelven como resultados `parserStatus: "ERROR"` en el nivel del elemento:
```json theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "ERROR",
"parserError": {
"code": "transaction_not_found",
"message": "transaction was not found"
}
}
]
```
#### Cuerpo de la solicitud
Firmas de las transacciones que se analizarán. El tamaño máximo del lote es 100.
Nivel de confirmación usado al obtener las transacciones.
* `confirmed`
* `finalized`
Cuando sea `true`, incluye la carga útil de la transacción sin procesar de Solana como `rawTransaction` en cada resultado.
#### Notas
* No se admite el nivel de confirmación `processed`.
* `rawTransaction` se omite a menos que `includeRawTransaction` sea `true`.
* Las transacciones que no se ejecuten correctamente aún pueden analizarse. En ese caso, `parsed.transactionStatus` es `ERROR` y, cuando está disponible, el error de la transacción se expone en `parsed.error`.
* Los errores de validación en el nivel de la solicitud devuelven una respuesta de error en lugar de resultados en el nivel del elemento.
### Historial de transacciones analizadas
`POST /v1/parsed-events/transaction-history` devuelve el historial de transacciones analizadas de una dirección. Admite paginación, límites de firmas, límites de slots, límites de tiempo de bloque, ordenamiento y transacciones sin procesar opcionales. El mismo método está disponible en GraphQL como `transactionsByAddress`.
A diferencia del endpoint de direcciones heredado de [Transacciones mejoradas](/docs/es/enhanced-transactions/transaction-history), los parámetros de la solicitud se envían en un cuerpo JSON y no como parámetros de la cadena de consulta.
#### Cuerpo de la solicitud
Dirección cuyo historial de transacciones se obtendrá.
Cantidad de transacciones que se devolverán. Debe estar entre `1` y `100`.
Devuelve las transacciones anteriores a esta firma.
Devuelve las transacciones posteriores a esta firma.
Cursor devuelto por la respuesta anterior.
Orden de las transacciones devueltas.
* `asc`
* `desc`
Nivel de confirmación usado para obtener el historial.
* `confirmed`
* `finalized`
Cuando sea `true`, incluye la carga útil de la transacción sin procesar de Solana como `rawTransaction` en cada resultado.
Límites de comparación de slots. Cada límite es opcional: `gt`, `gte`, `lt`, `lte`.
Límites de comparación del tiempo de bloque en segundos Unix. Cada límite es opcional: `gt`, `gte`, `lt`, `lte`.
#### Paginación
Las respuestas tienen esta estructura. Cada elemento `data` usa el mismo formato `TransactionResult` que devuelve Analizar transacciones:
```json [expandable] theme={"system"}
{
"data": [
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "OK",
"parsed": {
"slot": 433950192,
"blockTime": 1784487060,
"fee": 2005000,
"feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"transactionStatus": "OK",
"nativeTransfers": [],
"tokenTransfers": [],
"summary": {
"type": "swap",
"description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
"parsedData": {
"type": "swap",
"protocol": "jupiter",
"kind": "swap",
"in_amount": "1500000000000",
"actual_out_amount": "64672839261950",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"inner_swaps": [
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "470229300000",
"output_amount": "35579021038",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "1028270700000",
"output_amount": "77798063361",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "14625643887",
"output_amount": "8348494812168",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "35566391375",
"output_amount": "20283004384731",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "63185049137",
"output_amount": "36041340065051",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
}
]
}
},
"instructions": []
}
}
],
"paginationToken": "433950192:0"
}
```
Vuelve a pasar `paginationToken` en la siguiente solicitud para continuar. Si falta `paginationToken`, el servicio llegó al final del intervalo de páginas disponible.