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

# Разбор транзакций

> Преобразуйте подписи транзакций Solana в структурированные, удобочитаемые данные с помощью Helius Enhanced Transactions API.

<Warning>
  Enhanced Transactions API — это устаревший продукт в режиме технического обслуживания. Он по-прежнему работает, и эти страницы остаются доступными, но новые типы парсеров и функции больше не разрабатываются. Его преемник — [Parsed Events](/docs/ru/parsed-events), который декодирует инструкции с помощью каталога IDL и доступен на всех тарифах по цене 10 кредитов за запрос. В [руководстве по миграции](/docs/ru/parsed-events/guides/migrate-from-enhanced-transactions) пошагово описан переход. Вы также можете использовать [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress) для получения истории транзакций и заполнения пропущенных данных, а [Wallet API](/docs/ru/wallet-api/overview) — для получения удобочитаемых данных кошелька.
</Warning>

## Обзор

Эндпоинт Parse Transactions преобразует необработанные подписи транзакций в структурированную, удобочитаемую информацию. Вместо ручного декодирования данных инструкций и списков аккаунтов вы получаете понятные сведения о переводах, обменах, действиях с NFT и многом другом.

Отправьте запрос `POST` на `/v0/transactions`, указав до 100 подписей за один вызов.

## Когда использовать

* У вас есть одна или несколько подписей транзакций, и вы хотите получить предварительно обработанный, удобочитаемый результат.
* Вы показываете пользователю сведения об отдельной транзакции, например в кошельке или обозревателе.
* Вам нужны сводки событий — переводы SOL или токенов, действия с NFT — без написания собственного парсера.

Для новых проектов [`getTransaction`](/docs/ru/api-reference/rpc/http/gettransaction) возвращает необработанную транзакцию, а [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress) — это современный способ получения истории.

## Быстрый старт

<Steps>
  <Step title="Get your API key">
    Зарегистрируйтесь на [dashboard.helius.dev](https://dashboard.helius.dev) и скопируйте свой ключ API.
  </Step>

  <Step title="POST signatures to /v0/transactions">
    Передайте массив подписей в поле `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="Read the parsed response">
    Для каждой транзакции возвращаются описание, тип, переводы и сводки событий. См. раздел [Ответ](#ответ) ниже.
  </Step>
</Steps>

## Параметры запроса

<ParamField body="transactions" type="string[]" required>
  Массив подписей транзакций для разбора. До 100 подписей на один запрос.
</ParamField>

## Ответ

Каждая разобранная транзакция содержит удобочитаемое описание, а также структурированные данные о переводах и событиях:

```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
    }
  }
}
```

Каждая разобранная транзакция содержит:

* **`description`** — удобочитаемую сводку произошедшего.
* **`type`** — категорию транзакции (`TRANSFER`, `SWAP`, `NFT_SALE` и другие).
* **`source`** — программу, выполнившую транзакцию.
* **`fee`** / **`feePayer`** — комиссию за транзакцию в лампортах и оплативший ее аккаунт.
* **`nativeTransfers`** — перемещения SOL между аккаунтами.
* **`tokenTransfers`** — перемещения токенов SPL.
* **`events`** — высокоуровневые сводки событий.
* **`slot`** / **`timestamp`** — время обработки транзакции.

Полный каталог полей и все поддерживаемые типы транзакций приведены в [справочнике Parse Transactions API](/docs/ru/api-reference/enhanced-transactions/gettransactions).

## Дальнейшие действия

<CardGroup cols={2}>
  <Card title="Transaction History" icon="clock-rotate-left" href="/docs/ru/enhanced-transactions/transaction-history">
    Получайте удобочитаемую историю транзакций для адреса с поддержкой фильтрации и пагинации.
  </Card>

  <Card title="getTransactionsForAddress" icon="clock-rotate-left" href="/docs/ru/rpc/gettransactionsforaddress">
    Современная нативная для Helius замена для получения истории транзакций и заполнения пропущенных данных.
  </Card>

  <Card title="Wallet API" icon="wallet" href="/docs/ru/wallet-api/overview">
    REST-эндпоинты для получения удобочитаемых данных кошелька: балансов, истории и переводов.
  </Card>

  <Card title="Getting Data overview" icon="database" href="/docs/ru/getting-data">
    Сравните все варианты Helius для запросов данных Solana.
  </Card>
</CardGroup>


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