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

# getBlock

> Retorna informações de identidade e transações sobre um bloco confirmado no ledger.

## Parâmetros da Requisição

<ParamField body="slot" type="number" required>
  Número do slot como um inteiro `u64`.
</ParamField>

<ParamField body="commitment" type="string" default="finalized">
  O nível de compromisso para a requisição.

  * `finalized`
</ParamField>

<ParamField body="encoding" type="string" default="json">
  O formato de codificação para cada transação retornada.

  * `json`
  * `jsonParsed`
  * `base58`
  * `base64`
</ParamField>

<ParamField body="transactionDetails" type="string" default="full">
  Nível de detalhe da transação a ser retornado. Se as contas forem solicitadas, os detalhes da transação incluirão apenas assinaturas e uma lista anotada de contas em cada transação. Metadados da transação incluem apenas: fee, err, pre\_balances, post\_balances, pre\_token\_balances, e post\_token\_balances.

  * `full`
  * `accounts`
  * `signatures`
  * `none`
</ParamField>

<ParamField body="maxSupportedTransactionVersion" type="number">
  Versão máxima de transação a ser retornada nas respostas. Se o bloco solicitado contiver uma transação com uma versão superior, um erro será retornado. Se omitido, apenas transações legadas serão retornadas.
</ParamField>

<ParamField body="rewards" type="boolean" default="true">
  Se deve preencher o array de recompensas.
</ParamField>


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getBlock.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API avançada de recuperação de dados de blocos Solana para acessar
    informações abrangentes de blocos blockchain, incluindo transações,
    assinaturas e recompensas com níveis de detalhe configuráveis.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getBlock
      description: >
        Recupere informações detalhadas do bloco Solana para um número de slot
        especificado. Acesse dados completos do bloco, incluindo transações,
        assinaturas, alterações de conta, recompensas e informações de tempo.

        Configure o nível de detalhe da transação e o formato de codificação
        para otimizar para as necessidades específicas do seu aplicativo.
      operationId: getBlock
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: A versão do protocolo JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  description: Um identificador único para a solicitação.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getBlock
                  description: O nome do método RPC a ser invocado.
                  default: getBlock
                params:
                  type: array
                  description: Parâmetros para a solicitação.
                  default:
                    - 430
                  items:
                    oneOf:
                      - type: integer
                        description: Número do slot como um inteiro `u64`.
                        example: 430
                      - type: object
                        description: Opções adicionais de configuração para a solicitação.
                        properties:
                          commitment:
                            type: string
                            description: O nível de compromisso para a solicitação.
                            enum:
                              - finalized
                            default: finalized
                          encoding:
                            type: string
                            description: >-
                              O formato de codificação para cada transação
                              retornada.
                            enum:
                              - json
                              - jsonParsed
                              - base58
                              - base64
                            default: json
                          transactionDetails:
                            type: string
                            description: >-
                              Nível de detalhe da transação a ser retornado. Se
                              as contas forem solicitadas, os detalhes da
                              transação incluem apenas assinaturas e uma lista
                              anotada de contas em cada transação. Os metadados
                              da transação incluem apenas: taxa, erro,
                              saldos_anteriores, saldos_posteriores,
                              saldos_token_anteriores e
                              saldos_token_posteriores.
                            enum:
                              - full
                              - accounts
                              - signatures
                              - none
                            default: full
                          maxSupportedTransactionVersion:
                            type: integer
                            description: >-
                              Versão máxima de transação a ser retornada nas
                              respostas. Se o bloco solicitado contiver uma
                              transação com uma versão superior, um erro será
                              retornado. Se omitido, apenas transações legadas
                              serão retornadas.
                          rewards:
                            type: boolean
                            description: Se deve ou não preencher o array de recompensas.
                            default: true
      responses:
        '200':
          description: Detalhes do bloco recuperados com sucesso.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                  result:
                    type: object
                    properties:
                      blockhash:
                        type: string
                        description: >-
                          O blockhash deste bloco (string codificada em
                          base-58).
                        example: DUCT8VSgk2BXkMhQfxKVYfikEZCQf4dZ4ioPdGdaVxMN
                      previousBlockhash:
                        type: string
                        description: O blockhash do bloco pai.
                        example: HA2fJgGqmQezCXJRVNZAWPbRMXCPjUyo7VjRF47JGdYs
                      parentSlot:
                        type: integer
                        description: O índice de slot do bloco pai.
                        example: 429
                      transactions:
                        type: array
                        description: Array de detalhes da transação.
                        items:
                          type: object
                          properties:
                            meta:
                              type: object
                              nullable: true
                              description: Metadados associados à transação.
                            transaction:
                              type: object
                              description: Detalhes da transação.
                              properties:
                                message:
                                  type: object
                                  properties:
                                    accountKeys:
                                      type: array
                                      description: >-
                                        Array de chaves públicas de contas
                                        usadas nesta transação.
                                      items:
                                        type: string
                                    header:
                                      type: object
                                      properties:
                                        numReadonlySignedAccounts:
                                          type: integer
                                          description: >-
                                            Número de contas assinadas somente
                                            leitura.
                                        numReadonlyUnsignedAccounts:
                                          type: integer
                                          description: >-
                                            Número de contas não assinadas somente
                                            leitura.
                                        numRequiredSignatures:
                                          type: integer
                                          description: Número de assinaturas necessárias.
                                    instructions:
                                      type: array
                                      description: Array de instruções do programa.
                                      items:
                                        type: object
                                        properties:
                                          accounts:
                                            type: array
                                            description: Array de índices de conta.
                                            items:
                                              type: integer
                                          data:
                                            type: string
                                            description: >-
                                              Dados de entrada do programa codificados
                                              em base58.
                                          programIdIndex:
                                            type: integer
                                            description: >-
                                              Índice do ID do programa no array
                                              accountKeys.
                                          stackHeight:
                                            type: integer
                                            nullable: true
                                            description: Altura da pilha.
                                    recentBlockhash:
                                      type: string
                                      description: Blockhash recente usado nesta transação.
                                signatures:
                                  type: array
                                  description: >-
                                    Array de assinaturas para esta transação
                                    (codificado em base-58).
                                  items:
                                    type: string
                      blockTime:
                        type: integer
                        nullable: true
                        description: Tempo de produção estimado como timestamp Unix.
                        example: null
                      blockHeight:
                        type: integer
                        nullable: true
                        description: Número de blocos abaixo deste bloco.
                        example: null
                      rewards:
                        type: array
                        description: Recompensas para o bloco.
                        items:
                          type: object
                          properties:
                            pubkey:
                              type: string
                              description: >-
                                A chave pública da conta que recebeu a
                                recompensa.
                            lamports:
                              type: integer
                              description: >-
                                Número de lamports de recompensa creditados ou
                                debitados.
                            rewardType:
                              type: string
                              nullable: true
                              description: Tipo de recompensa (por exemplo, "fee", "rent").
        '400':
          description: >-
            Solicitação Inválida - Parâmetros de solicitação inválidos ou
            solicitação malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parâmetros inválidos
                id: '1'
        '401':
          description: Não autorizado - Chave de API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Não autorizado
                id: '1'
        '429':
          description: Muitas Solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Muitas solicitações
                id: '1'
        '500':
          description: Erro Interno do Servidor - Um erro ocorreu no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Erro interno
                id: '1'
        '503':
          description: Serviço Indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Serviço indisponível
                id: '1'
        '504':
          description: Tempo Limite do Gateway - A solicitação expirou.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tempo limite do gateway
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          enum:
            - '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave de API Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````