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

# Parse Transactions

> Analise assinaturas de transações Solana em dados estruturados e legíveis para humanos com a Helius Enhanced Transactions API.

<Warning>
  A Enhanced Transactions API é um produto legado em modo de manutenção. Ela ainda funciona e essas páginas continuam disponíveis, mas não está recebendo novos tipos de analisadores ou desenvolvimento de recursos. Seu sucessor é o [Parsed Events](/docs/pt-BR/parsed-events), que decodifica instruções através do catálogo IDL e está em beta fechado. Você também pode usar [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress) para histórico de transações e preenchimento retroativo, e a [Wallet API](/docs/pt-BR/wallet-api/overview) para dados de carteira legíveis por humanos.
</Warning>

## Visão Geral

O endpoint Parse Transactions transforma assinaturas de transações brutas em informações estruturadas e legíveis por humanos. Em vez de decodificar manualmente dados de instruções e listas de contas, você recebe detalhes claros sobre transferências, trocas, atividades de NFT e mais.

Envie uma solicitação `POST` para `/v0/transactions` com até 100 assinaturas por chamada.

## Quando usá-lo

* Você tem uma ou mais assinaturas de transações e deseja uma saída pré-analisada e legível por humanos.
* Você está exibindo os detalhes de uma única transação para um usuário (carteiras, exploradores).
* Você precisa de resumos de eventos (transferências SOL/token, atividade NFT) sem escrever seu próprio analisador.

Para novas construções, [`getTransaction`](/docs/pt-BR/api-reference/rpc/http/gettransaction) retorna a transação bruta, e [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress) é o caminho moderno para o histórico.

## Início Rápido

<Steps>
  <Step title="Obtenha sua chave API">
    Inscreva-se em [dashboard.helius.dev](https://dashboard.helius.dev) e copie sua chave API.
  </Step>

  <Step title="POST assinaturas para /v0/transactions">
    Passe um array de assinaturas no campo de corpo `transactions`.

    <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="Leia a resposta analisada">
    Cada transação retorna com uma descrição, tipo, transferências e resumos de eventos. Veja [Resposta](#response) abaixo.
  </Step>
</Steps>

## Parâmetros de solicitação

<ParamField body="transactions" type="string[]" required>
  Array de assinaturas de transações a serem analisadas. Até 100 assinaturas por solicitação.
</ParamField>

## Resposta

Cada transação analisada inclui uma descrição legível por humanos junto com dados estruturados de transferências e 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 transação analisada inclui:

* **`description`** — resumo legível por humanos do que aconteceu.
* **`type`** — categoria da transação (`TRANSFER`, `SWAP`, `NFT_SALE` e outros).
* **`source`** — o programa que executou a transação.
* **`fee`** / **`feePayer`** — taxa de transação em lamports e a conta que a pagou.
* **`nativeTransfers`** — movimentos de SOL entre contas.
* **`tokenTransfers`** — movimentos de tokens SPL.
* **`events`** — resumos de eventos de alto nível.
* **`slot`** / **`timestamp`** — quando a transação foi processada.

Para o catálogo completo de campos e todos os tipos de transações suportados, consulte a [Referência da API Parse Transactions](/docs/pt-BR/api-reference/enhanced-transactions/gettransactions).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Histórico de Transações" icon="clock-rotate-left" href="/docs/pt-BR/enhanced-transactions/transaction-history">
    Recupere o histórico de transações legível por humanos para um endereço, com filtragem e paginação.
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/pt-BR/rpc/gettransactionsforaddress">
    A substituição moderna, nativa do Helius para histórico de transações e preenchimento retroativo.
  </Card>

  <Card title="Wallet API" icon="wallet" href="/docs/pt-BR/wallet-api/overview">
    Endpoints REST para dados de carteira legíveis por humanos: saldos, histórico e transferências.
  </Card>

  <Card title="Visão Geral dos Dados" icon="database" href="/docs/pt-BR/getting-data">
    Compare todas as opções Helius para consulta de dados Solana.
  </Card>
</CardGroup>