Início Rápido de Eventos Analisados

Novo em Eventos Analisados? Leia primeiro o modelo mental dos Streams Analisados — Eventos Analisados retornam as mesmas instruções decodificadas via REST e GraphQL.

Início Rápido

Obter Acesso

Parsed Events está em beta aberta, disponível em planos pagos. Obtenha sua chave de API no Helius Dashboard e envie solicitações para https://mainnet.helius-rpc.com.Autentique-se com a chave de API do seu projeto, passada como o parâmetro de consulta api-key.

Analisar uma Transação

Passe assinaturas no campo de corpo transactions de POST /v1/parsed-events/transactions:

JavaScript
cURL

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();

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

Ler o Resultado

A resposta contém um resultado por assinatura solicitada, na ordem de entrada. Cada resultado inclui signature, parserStatus, e ou parsed ou parserError:

[
  {
    "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
        }
      ]
    }
  }
]

O exemplo é reduzido a 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 pode decodificar, o que deixa instructionName como null enquanto rawData e rawAccounts permanecem disponíveis. Veja Resposta Analisada para cada campo e um exemplo de resposta completo.

Buscar Histórico de Endereços

POST /v1/parsed-events/transaction-history retorna os mesmos resultados analisados acima, para cada transação que tocou um endereço, sendo a mais recente primeiro por padrão:

JavaScript
cURL

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();

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"
    }'

Paginar

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

Buscar Pump.fun Mints

Navegue por cada token que uma carteira implantou no Pump.fun.

Consultar com GraphQL

Selecione exatamente os campos analisados que seu aplicativo precisa.

Migrar de Transações Aprimoradas

Mapeamento de ponto de extremidade, parâmetro e resposta da API legada.

Referência REST

Ambos os métodos REST aceitam um corpo JSON via POST sob /v1/parsed-events/ em https://mainnet.helius-rpc.com, autenticados com o parâmetro de consulta api-key. Corpos de solicitação rejeitam campos desconhecidos, de modo que erros de digitação falham de forma clara, em vez de serem ignorados silenciosamente. Consultas GraphQL vão para POST /v1/parsed-events/graphql.

Analisar Transações

POST /v1/parsed-events/transactions busca transações completas do Solana por assinatura, decodifica-as com o mesmo decodificador de instrução baseado em IDL que alimenta 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":

[
  {
    "signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
    "parserStatus": "ERROR",
    "parserError": {
      "code": "transaction_not_found",
      "message": "transaction was not found"
    }
  }
]

Corpo da Solicitação

string[]

obrigatório

Assinaturas de transações para analisar. O tamanho máximo do lote é 100.

string

padrão:"confirmed"

Nível de compromisso usado ao buscar transações.

confirmed
finalized

boolean

padrão:"false"

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 /v1/parsed-events/transaction-history retorna histórico de transações analisadas para um endereço. Suporta 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 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

string

obrigatório

Endereço cujo histórico de transações deve ser buscado.

number

padrão:"100"

Número de transações a serem retornadas. Deve estar entre 1 e 100.

string

Retornar transações antes desta assinatura.

string

Retornar transações depois desta assinatura.

string

Cursor retornado pela resposta anterior.

string

padrão:"desc"

Ordem de classificação para transações retornadas.

asc
desc

string

padrão:"confirmed"

Nível de compromisso usado para buscar o histórico.

confirmed
finalized

boolean

padrão:"false"

Quando true, inclui a carga útil da transação Solana bruta como rawTransaction em cada resultado.

object

Limites de comparação de slot. Cada limite é opcional: gt, gte, lt, lte.

object

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:

{
  "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.

Primeiros Passos

Transmissão de Dados e Audição de Eventos

APIs de Dados & RPCs

Negociação

Enviando Transações

Carteira como Serviço

Privacidade

Recursos

Início Rápido de Eventos Analisados

Início Rápido

Guias

Buscar Pump.fun Mints

Consultar com GraphQL

Migrar de Transações Aprimoradas

Referência REST

Analisar Transações

Corpo da Solicitação

Notas

Histórico de Transações Analisado

Corpo da Solicitação

Paginação

​Início Rápido

​Guias

Buscar Pump.fun Mints

Consultar com GraphQL

Migrar de Transações Aprimoradas

​Referência REST

​Analisar Transações

​Corpo da Solicitação

​Notas

​Histórico de Transações Analisado

​Corpo da Solicitação

​Paginação

Início Rápido

Guias

Referência REST

Analisar Transações

Corpo da Solicitação

Notas

Histórico de Transações Analisado

Corpo da Solicitação

Paginação