> ## 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.
# Краткое руководство по Parsed Events
> Разберите первую транзакцию, получите разобранную историю адреса и просматривайте результаты постранично. Также здесь приведена справочная документация REST для обеих конечных точек.
Впервые работаете с Parsed Events? Сначала ознакомьтесь с [ментальной моделью](/docs/ru/parsed-streams#ментальная-модель) Parsed Streams — Parsed Events возвращает те же декодированные инструкции через REST.
## Краткое руководство
Parsed Events доступен на всех тарифах по цене 10 кредитов за запрос. Получите ключ API в [панели управления Helius](https://dashboard.helius.dev) и отправляйте запросы на `https://mainnet.helius-rpc.com`.
Для аутентификации передайте ключ API вашего проекта в параметре запроса `api-key`.
Передайте подписи в поле `transactions` тела запроса к `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
}'
```
Ответ содержит по одному результату для каждой запрошенной подписи в порядке их передачи. Каждый результат включает `signature`, `parserStatus` и либо `parsed`, либо `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
}
]
}
}
]
```
Пример сокращен до двух инструкций: декодированной передачи токена внутри маршрута и инструкции AMM, программа которой известна каталогу, но не может быть декодирована. Поэтому `instructionName` остается равным `null`, а `rawData` и `rawAccounts` остаются доступными. Все поля и полный пример ответа приведены в разделе [Разобранный ответ](/docs/ru/parsed-events/parsed-response).
`POST /v1/parsed-events/transaction-history` возвращает те же разобранные результаты, что и выше, для каждой транзакции, затронувшей адрес. По умолчанию сначала возвращаются самые новые транзакции:
```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"
}'
```
В ответах с историей результаты помещаются в объект страницы. Чтобы продолжить, передайте `paginationToken` в следующем запросе. Если `paginationToken` отсутствует, сервис достиг конца доступного диапазона страниц.
## Руководства
Постранично получите все токены, развернутые кошельком на Pump.fun.
Сопоставление конечных точек, параметров и ответов с устаревшим API.
## Справочник REST
Оба метода REST принимают тело JSON через `POST` в `/v1/parsed-events/` по адресу `https://mainnet.helius-rpc.com` и используют для аутентификации параметр запроса `api-key`. Неизвестные поля в теле запроса отклоняются, поэтому опечатки приводят к явной ошибке, а не игнорируются без уведомления.
### Разбор транзакций
`POST /v1/parsed-events/transactions` получает полные транзакции Solana по подписи, декодирует их с помощью того же основанного на IDL декодера инструкций, который используется в [Parsed Streams](/docs/ru/parsed-streams), и возвращает по одному `TransactionResult` для каждой запрошенной подписи.
Порядок ответов соответствует порядку входных данных, включая повторяющиеся подписи. Для отсутствующих транзакций и ошибок синтаксического анализа отдельных элементов возвращаются результаты `parserStatus: "ERROR"` на уровне элемента:
```json theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "ERROR",
"parserError": {
"code": "transaction_not_found",
"message": "transaction was not found"
}
}
]
```
#### Тело запроса
Подписи транзакций для разбора. Максимальный размер пакета — 100.
Уровень подтверждения, используемый при получении транзакций.
* `confirmed`
* `finalized`
Если указано `true`, включить исходные данные транзакции Solana в каждый результат как `rawTransaction`.
#### Примечания
* Уровень подтверждения `processed` не поддерживается.
* `rawTransaction` не включается, если `includeRawTransaction` не имеет значения `true`.
* Транзакции с ошибками выполнения все равно могут быть разобраны. В этом случае `parsed.transactionStatus` имеет значение `ERROR`, а ошибка транзакции, если она доступна, указывается в `parsed.error`.
* При ошибках проверки на уровне запроса вместо результатов отдельных элементов возвращается ответ с ошибкой.
### История разобранных транзакций
`POST /v1/parsed-events/transaction-history` возвращает разобранную историю транзакций для адреса. Поддерживаются разбиение на страницы, границы по подписям, слотам и времени блока, порядок сортировки и необязательное включение исходных транзакций.
В отличие от конечной точки адреса устаревшего API [Enhanced Transactions](/docs/ru/enhanced-transactions/transaction-history), параметры запроса передаются в теле JSON, а не в строке запроса.
#### Тело запроса
Адрес, для которого необходимо получить историю транзакций.
Количество возвращаемых транзакций. Значение должно находиться между `1` и `100`.
Вернуть транзакции до этой подписи.
Вернуть транзакции после этой подписи.
Курсор, возвращенный в предыдущем ответе.
Порядок сортировки возвращаемых транзакций.
* `asc`
* `desc`
Уровень подтверждения, используемый при получении истории.
* `confirmed`
* `finalized`
Если указано `true`, включить исходные данные транзакции Solana в каждый результат как `rawTransaction`.
Границы сравнения слотов. Каждая граница необязательна: `gt`, `gte`, `lt`, `lte`.
Границы сравнения времени блока в секундах Unix. Каждая граница необязательна: `gt`, `gte`, `lt`, `lte`.
#### Разбиение на страницы
Ответы имеют следующую структуру. Каждый элемент `data` использует тот же формат `TransactionResult`, который возвращается при разборе транзакций:
```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"
}
```
Чтобы продолжить, передайте `paginationToken` в следующем запросе. Если `paginationToken` отсутствует, сервис достиг конца доступного диапазона страниц.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.