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

# Analizar transacciones

> Analiza firmas de transacciones de Solana y conviértelas en datos estructurados y legibles mediante la API de transacciones mejoradas de Helius.

<Warning>
  La API de transacciones mejoradas es un producto heredado en modo de mantenimiento. Sigue funcionando y estas páginas continúan disponibles, pero ya no recibe nuevos tipos de analizadores ni mejoras de funcionalidades. Su sucesor es [Eventos analizados](/docs/es/parsed-events), que decodifica instrucciones mediante el catálogo de IDL y se encuentra en beta abierta en los planes de pago. La [guía de migración](/docs/es/parsed-events/guides/migrate-from-enhanced-transactions) explica el proceso paso a paso. También puedes usar [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress) para el historial de transacciones y la recuperación de datos históricos, y la [API de billeteras](/docs/es/wallet-api/overview) para obtener datos de billeteras legibles.
</Warning>

## Descripción general

El endpoint Analizar transacciones transforma firmas de transacciones sin procesar en información estructurada y legible. En lugar de decodificar manualmente los datos de las instrucciones y las listas de cuentas, recibes detalles claros sobre transferencias, intercambios, actividades con NFT y mucho más.

Envía una solicitud `POST` a `/v0/transactions` con hasta 100 firmas por llamada.

## Cuándo usarlo

* Tienes una o más firmas de transacciones y quieres un resultado preanalizado y legible.
* Quieres mostrar a un usuario los detalles de una sola transacción (billeteras, exploradores).
* Necesitas resúmenes de eventos (transferencias de SOL o tokens, actividad con NFT) sin escribir tu propio analizador.

Para desarrollos nuevos, [`getTransaction`](/docs/es/api-reference/rpc/http/gettransaction) devuelve la transacción sin procesar, y [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress) es la opción moderna para consultar el historial.

## Inicio rápido

<Steps>
  <Step title="Get your API key">
    Regístrate en [dashboard.helius.dev](https://dashboard.helius.dev) y copia tu clave de API.
  </Step>

  <Step title="POST signatures to /v0/transactions">
    Pasa un arreglo de firmas en el campo `transactions` del cuerpo.

    <Tabs>
      <Tab title="JavaScript">
        ```javascript theme={"system"}
        const parseTransaction = async () => {
          const url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY";

          const response = await fetch(url, {
            method: 'POST',
            headers: {
              'Content-Type': 'application/json',
            },
            body: JSON.stringify({
              transactions: ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"],
            }),
          });

          const data = await response.json();
          console.log("Parsed transaction:", data);
        };

        parseTransaction();
        ```
      </Tab>

      <Tab title="Python">
        ```python theme={"system"}
        import requests
        import json

        def parse_transaction():
            url = "https://mainnet.helius-rpc.com/v0/transactions/?api-key=YOUR_API_KEY"

            payload = {
                "transactions": ["5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP"]
            }

            response = requests.post(url, json=payload)
            data = response.json()
            print("Parsed transaction:", data)

        parse_transaction()
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Read the parsed response">
    Cada transacción se devuelve con una descripción, un tipo, transferencias y resúmenes de eventos. Consulta la sección [Respuesta](#respuesta) a continuación.
  </Step>
</Steps>

## Parámetros de la solicitud

<ParamField body="transactions" type="string[]" required>
  Arreglo de firmas de transacciones que se analizarán. Se permiten hasta 100 firmas por solicitud.
</ParamField>

## Respuesta

Cada transacción analizada incluye una descripción legible junto con datos estructurados de transferencias y eventos:

```json theme={"system"}
{
  "description": "Transfer 0.1 SOL to FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
  "type": "TRANSFER",
  "source": "SYSTEM_PROGRAM",
  "fee": 5000,
  "feePayer": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
  "signature": "5rfFLBUp5YPr6rC2g1KBBW8LGZBcZ8Lvs7gKAdgrBjmQvFf6EKkgc5cpAQUTwGxDJbNqtLYkjV5vS5zVK4tb6JtP",
  "slot": 171341028,
  "timestamp": 1674080473,
  "nativeTransfers": [
    {
      "fromUserAccount": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "toUserAccount": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 100000000
    }
  ],
  "events": {
    "sol": {
      "from": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
      "to": "FXvStt8aeQHMGKDgqaQ2HXWfJsXnqiKSoBEpHJahkuD",
      "amount": 0.1
    }
  }
}
```

Cada transacción analizada incluye:

* **`description`** — resumen legible de lo que ocurrió.
* **`type`** — categoría de la transacción (`TRANSFER`, `SWAP`, `NFT_SALE` y otras).
* **`source`** — programa que ejecutó la transacción.
* **`fee`** / **`feePayer`** — comisión de la transacción en lamports y cuenta que la pagó.
* **`nativeTransfers`** — movimientos de SOL entre cuentas.
* **`tokenTransfers`** — movimientos de tokens SPL.
* **`events`** — resúmenes de eventos de alto nivel.
* **`slot`** / **`timestamp`** — momento en que se procesó la transacción.

Para consultar el catálogo completo de campos y todos los tipos de transacciones compatibles, consulta la [referencia de la API Analizar transacciones](/docs/es/api-reference/enhanced-transactions/gettransactions).

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Transaction History" icon="clock-rotate-left" href="/docs/es/enhanced-transactions/transaction-history">
    Obtén el historial de transacciones legible de una dirección, con filtros y paginación.
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/es/rpc/gettransactionsforaddress">
    El reemplazo moderno y nativo de Helius para el historial de transacciones y la recuperación de datos históricos.
  </Card>

  <Card title="Wallet API" icon="wallet" href="/docs/es/wallet-api/overview">
    Endpoints REST para obtener datos de billeteras legibles: saldos, historial y transferencias.
  </Card>

  <Card title="Getting Data overview" icon="database" href="/docs/es/getting-data">
    Compara todas las opciones de Helius para consultar datos de Solana.
  </Card>
</CardGroup>
