> ## 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.
# Início Rápido de Eventos Analisados
> Analise sua primeira transação, busque o histórico de endereços analisados e pagine pelos resultados. Além disso, a referência REST para ambos os endpoints.
Novo em Eventos Analisados? Leia primeiro o [modelo mental](/docs/pt-BR/parsed-streams#the-mental-model) dos Streams Analisados — Eventos Analisados retornam as mesmas instruções decodificadas via REST e GraphQL.
## Início Rápido
Eventos Analisados estão em beta fechado. Confirme que está habilitado para seu projeto. Para participar do beta fechado, [inscreva-se aqui](https://form.typeform.com/to/BlFWKbC9).
Autentique-se com a chave de API do seu projeto, passada como o parâmetro de consulta `api-key`.
Passe assinaturas no campo de corpo `transactions` de `POST /transactions`:
```javascript theme={"system"}
const parseTransactions = async () => {
const url = "https:///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:///transactions?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"transactions": [
"5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
],
"includeRawTransaction": false
}'
```
A resposta contém um resultado por assinatura solicitada, na ordem de entrada. Cada resultado inclui `signature`, `parserStatus`, e ou `parsed` ou `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": [
{
"topIxIdx": 5,
"innerIxIdx": 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
}
]
}
},
{
"topIxIdx": 5,
"innerIxIdx": 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
}
]
}
}
]
```
O exemplo é reduzido para duas instruções: uma transferência de token decodificada dentro da rota, e uma instrução AMM cujo programa o catálogo conhece, mas não consegue decodificar, deixando `instructionName` como `null` enquanto `rawData` e `rawAccounts` permanecem disponíveis. Veja [Resposta Analisada](/docs/pt-BR/parsed-events/parsed-response) para cada campo e um exemplo completo de resposta.
`POST /transaction-history` retorna os mesmos itens `TransactionResult` para um endereço, do mais recente ao mais antigo por padrão:
```javascript theme={"system"}
const fetchTransactionHistory = async () => {
const url = "https:///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:///transaction-history?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"limit": 100,
"sortOrder": "desc",
"commitment": "confirmed"
}'
```
As respostas de histórico envolvem resultados em um objeto de página. Passe `paginationToken` de volta na próxima solicitação para continuar. Se `paginationToken` estiver faltando, o serviço atingiu o fim do intervalo de páginas disponíveis.
## Guias
Pagine por cada token que uma carteira implantou no Pump.fun.
Selecione exatamente os campos analisados que seu app precisa.
## Referência REST
Ambos os endpoints aceitam um corpo JSON via `POST` no endpoint que a equipe Helius compartilha com você, autenticado com o parâmetro de consulta `api-key`. Os corpos das solicitações rejeitam campos desconhecidos, de modo que erros de digitação são falhas evidentes em vez de serem silenciosamente ignorados.
### Analisar Transações
`POST /transactions` busca transações completas do Solana por assinatura, as decodifica com o mesmo decodificador de instruções baseado em IDL que alimenta [Streams Analisados](/docs/pt-BR/parsed-streams), e retorna um `TransactionResult` por assinatura solicitada. O mesmo método está disponível em GraphQL como `transactions`.
A ordem da resposta corresponde à ordem de entrada, incluindo assinaturas duplicadas. Transações ausentes e falhas de analisador por item são retornadas como resultados em nível de item `parserStatus: "ERROR"`:
```json theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "ERROR",
"parserError": {
"code": "transaction_not_found",
"message": "transaction was not found"
}
}
]
```
#### Corpo da Solicitação
Assinaturas de transações para analisar. O tamanho máximo do lote é 100.
Nível de compromisso usado ao buscar transações.
* `confirmed`
* `finalized`
Quando `true`, inclui a carga útil bruta da transação Solana como `rawTransaction` em cada resultado.
#### Notas
* O compromisso `processed` não é suportado.
* `rawTransaction` é omitido a menos que `includeRawTransaction` seja `true`.
* Falhas de execução de transações ainda podem ser analisadas. Nesse caso, `parsed.transactionStatus` é `ERROR`, e o erro da transação é exposto em `parsed.error` quando disponível.
* Erros de validação em nível de solicitação retornam uma resposta de erro em vez de resultados em nível de item.
### Histórico de Transações Analisado
`POST /transaction-history` retorna o histórico de transações analisadas para um endereço. Ele oferece suporte a paginação, limites de assinatura, limites de slot, limites de tempo de bloco, ordem de classificação e transações brutas opcionais. O mesmo método está disponível em GraphQL como `transactionsByAddress`.
Ao contrário do endpoint de endereço [Transações Aprimoradas](/docs/pt-BR/enhanced-transactions/transaction-history) legado, os parâmetros da solicitação são enviados em um corpo JSON em vez de parâmetros de string de consulta.
#### Corpo da Solicitação
Endereço cujo histórico de transações deve ser buscado.
Número de transações a serem retornadas. Deve estar entre `1` e `100`.
Retornar transações antes desta assinatura.
Retornar transações depois desta assinatura.
Cursor retornado pela resposta anterior.
Ordem de classificação para transações retornadas.
* `asc`
* `desc`
Nível de compromisso usado para buscar o histórico.
* `confirmed`
* `finalized`
Quando `true`, inclui a carga útil da transação Solana bruta como `rawTransaction` em cada resultado.
Limites de comparação de slot. Cada limite é opcional: `gt`, `gte`, `lt`, `lte`.
Limites de comparação de tempo de bloco em segundos Unix. Cada limite é opcional: `gt`, `gte`, `lt`, `lte`.
#### Paginação
As respostas têm este formato. Cada item `data` usa o mesmo formato `TransactionResult` retornado por Transações Analisadas:
```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"
}
```
Passe `paginationToken` de volta na próxima solicitação para continuar. Se `paginationToken` estiver faltando, o serviço atingiu o fim do intervalo de páginas disponíveis.