> ## 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 Priority Fee API: Estimativa Inteligente de Taxas de Transação

> Estime taxas prioritárias ideais para transações Solana. Análise de taxas em tempo real com seis níveis de prioridade para garantir confirmação rápida e eficiência de custos.

<Info>
  **Economize dinheiro, melhore o desempenho**: Obtenha estimativas precisas de taxas prioritárias com base nas condições de rede em tempo real. Pague apenas o necessário pela velocidade desejada.
</Info>

## O que são Taxas Prioritárias?

No Solana, as taxas prioritárias permitem que suas transações avancem na fila do validador durante a congestão da rede. Pense nelas como faixas expressas para suas transações.

<CardGroup cols={2}>
  <Card title="Taxas Base vs Taxas Prioritárias" icon="coins">
    **Taxas base** são custos fixos para processamento de transações

    **Taxas prioritárias** são pagamentos opcionais para processamento mais rápido
  </Card>

  <Card title="Como Funcionam" icon="rocket">
    Você define um preço por unidade de computação - preços mais altos são processados primeiro durante a congestão da rede
  </Card>
</CardGroup>

## Por que usar Taxas Prioritárias

As taxas prioritárias são agora uma parte padrão das transações Solana, ajudando a garantir tempos de confirmação confiáveis e desempenho ideal da rede.

<CardGroup cols={2}>
  <Card title="Confirmação Confiável" icon="circle-check">
    Garanta que suas transações sejam confirmadas de forma rápida e confiável, mesmo durante condições variáveis da rede
  </Card>

  <Card title="Vantagem Competitiva" icon="trophy">
    Mantenha-se competitivo em operações sensíveis ao tempo, como negociações, minting e interações DeFi
  </Card>

  <Card title="Experiência do Usuário" icon="heart">
    Forneça processamento de transações consistente e rápido para melhor experiência do usuário
  </Card>

  <Card title="Eficiência da Rede" icon="gauge">
    Ajude a otimizar a alocação de recursos da rede e o desempenho geral
  </Card>
</CardGroup>

## Níveis de Prioridade Explicados

Nossa API fornece seis níveis de prioridade com base na atividade recente da rede:

<AccordionGroup>
  <Accordion title="Min">
    **Menor taxa observada** - Com base nas taxas mínimas vistas nos slots recentes

    **Melhor para**: Transações não urgentes quando a otimização de custo é prioridade

    **Nota**: Pode resultar em tempos de confirmação mais lentos
  </Accordion>

  <Accordion title="Baixa">
    **25º percentil** - Opção econômica com tempos de confirmação razoáveis

    **Melhor para**: Operações padrão onde a velocidade não é crítica

    **Nota**: Bom equilíbrio de custo e confiabilidade
  </Accordion>

  <Accordion title="Média (Recomendada)">
    **50º percentil** - Taxa mediana proporcionando tempos de confirmação confiáveis

    **Melhor para**: A maioria das aplicações e casos de uso geral

    **Nota**: Ponto de partida recomendado para a maioria dos desenvolvedores
  </Accordion>

  <Accordion title="Alta">
    **75º percentil** - Taxas mais altas para processamento mais rápido

    **Melhor para**: Operações sensíveis ao tempo e cenários competitivos

    **Nota**: Processamento priorizado durante atividade na rede
  </Accordion>

  <Accordion title="Muito Alta">
    **95º percentil** - Taxas premium para máxima velocidade

    **Melhor para**: Operações críticas, estratégias MEV, transações urgentes

    **Nota**: Confirmação rápida mesmo durante alta atividade na rede
  </Accordion>

  <Accordion title="Máxima Insegura">
    **Máxima observada** - Maiores taxas vistas nos slots recentes

    **Melhor para**: Somente em situações de emergência

    **Aviso**: Frequentemente desnecessariamente alta - use com cautela
  </Accordion>
</AccordionGroup>

<Warning>
  **Cálculo de Custo**: Taxa prioritária total = Preço por unidade de computação × Unidades de computação consumidas

  Uma transação típica usa 200.000-400.000 unidades de computação. No nível Médio atual (\~40.000 microlamports por unidade), são 0,000008-0,000016 SOL em taxas prioritárias. Sempre verifique as condições atuais da rede para estimativas precisas.
</Warning>

## Métodos de Implementação

<CardGroup cols={2}>
  <Card title="Transação Serializada (Recomendada)" icon="file-code" href="/docs/pt-BR/priority-fee/estimating-fees-using-serialized-transaction">
    **Método Principal** - Analisa sua transação exata para máxima precisão

    **Melhor para**: A maioria das aplicações e casos de uso em produção

    **Benefícios**:

    * Análise específica por instrução
    * Maior precisão
    * Pronto para produção
    * Considera a complexidade da transação
  </Card>

  <Card title="Chaves de Conta (Avançado)" icon="key" href="/docs/pt-BR/priority-fee/estimating-fees-using-account-keys">
    **Casos de Uso Especializados** - Estimativas baseadas em padrões de conta

    **Melhor para**: Análise pré-transação, operações em lote, arquiteturas especializadas

    **Benefícios**:

    * Análise de padrão ao nível de conta
    * Útil para planejamento e pesquisa
    * Análise de conta em lote
  </Card>
</CardGroup>

## Exemplo de Início Rápido

<CodeGroup>
  ```javascript JavaScript theme={"system"}
  import { Transaction, SystemProgram, ComputeBudgetProgram } from "@solana/web3.js";
  import bs58 from "bs58";

  // 1. Build your transaction (without priority fee)
  const transaction = new Transaction();
  const transferIx = SystemProgram.transfer({
    fromPubkey: senderKeypair.publicKey,
    toPubkey: recipientPublicKey,
    lamports: 1000000, // 0.001 SOL
  });
  transaction.add(transferIx);

  // 2. Set required fields and serialize
  transaction.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
  transaction.feePayer = senderKeypair.publicKey;
  const serializedTx = bs58.encode(transaction.serialize());

  // 3. Get priority fee estimate
  const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: "1",
      method: "getPriorityFeeEstimate",
      params: [{
        transaction: serializedTx,
        options: { 
          priorityLevel: "Medium",
          recommended: true 
        }
      }]
    })
  });

  const result = await response.json();
  const priorityFee = result.result.priorityFeeEstimate;

  // 4. Add priority fee and send
  transaction.instructions = []; // Reset
  transaction.add(ComputeBudgetProgram.setComputeUnitPrice({ microLamports: priorityFee }));
  transaction.add(transferIx);
  transaction.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
  transaction.sign(senderKeypair);
  ```

  ```python Python theme={"system"}
  import requests
  import base58
  from solana.transaction import Transaction
  from solana.system_program import transfer, TransferParams

  # 1. Build and serialize your transaction
  # (transaction building code here)
  serialized_tx = base58.b58encode(transaction.serialize()).decode('utf-8')

  # 2. Get priority fee estimate
  response = requests.post(
      "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY",
      json={
          "jsonrpc": "2.0",
          "id": "1",
          "method": "getPriorityFeeEstimate",
          "params": [{
              "transaction": serialized_tx,
              "options": {
                  "priorityLevel": "Medium",
                  "recommended": True
              }
          }]
      }
  )

  result = response.json()
  priority_fee = result["result"]["priorityFeeEstimate"]
  print(f"Recommended priority fee: {priority_fee} micro-lamports")

  # 3. Rebuild transaction with priority fee and send
  ```

  ```curl cURL theme={"system"}
  curl -X POST "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": "1",
      "method": "getPriorityFeeEstimate",
      "params": [{
        "transaction": "SERIALIZED_TRANSACTION_BASE58",
        "options": {
          "priorityLevel": "Medium",
          "recommended": true
        }
      }]
    }'
  ```
</CodeGroup>

## Referência de API

<Card title="getPriorityFeeEstimate" icon="code" href="/docs/pt-BR/api-reference/priority-fee/getpriorityfeeestimate">
  Documentação completa da API com todos os parâmetros e formatos de resposta
</Card>

## Monitoramento da Rede em Tempo Real

<Tip>
  **Dica profissional**: Monitore as condições da rede para otimizar sua estratégia de taxa prioritária. Durante condições normais, use níveis de prioridade mais baixos. Durante a congestão, considere níveis mais altos para operações sensíveis ao tempo.

  Você pode verificar as condições atuais da rede usando exploradores Solana ou o método `getRecentPerformanceSamples` RPC.
</Tip>

## Suporte e Recursos

<CardGroup cols={2}>
  <Card title="Comunidade Discord" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    Obtenha ajuda da comunidade e da equipe Helius
  </Card>

  <Card title="Suporte Direto" icon="headset" href="/docs/pt-BR/support">
    Perguntas sobre taxas prioritárias e assistência em otimização
  </Card>
</CardGroup>