> ## 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.
# getBlocksWithLimit
> Retorna uma lista de blocos confirmados começando no slot fornecido.
## Parâmetros da Requisição
Número do slot inicial de Solana a partir do qual começar a recuperar a lista sequencial de blocos.
Número máximo de blocos sequenciais a retornar (até 500.000 blocos por requisição).
Nível de finalização para consultar blocos - confirmado (confirmação otimista) ou finalizado (confirmação completa).
* `confirmed`
* `finalized`
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getBlocksWithLimit.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de histórico de blockchain para recuperar slots de bloco Solana
sequenciais dentro de um intervalo especificado com controles de limite
personalizáveis para otimizar o volume de dados e o desempenho das
consultas.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint Mainnet RPC
- url: https://devnet.helius-rpc.com
description: Endpoint Devnet RPC
security: []
paths:
/:
post:
tags:
- RPC
summary: getBlocksWithLimit
description: >
Recuperar uma sequência contínua de blocos Solana a partir de um slot
específico com um limite personalizável.
Esta API de histórico de blockchain retorna uma matriz de números de
slots de blocos confirmados dentro do intervalo solicitado,
permitindo paginação eficiente através de blocos históricos. O parâmetro
de limite controlado ajuda a gerenciar
o tamanho da resposta e o desempenho ao verificar grandes seções do
blockchain. Essencial para exploradores de blockchain,
ferramentas de análise de dados históricos, sistemas de auditoria de
histórico de transações, serviços de indexação,
plataformas de análise de dados e aplicativos que precisam processar
blocos sequenciais de forma eficiente sem
sobrecarregar a memória ou as restrições de rede. Limitado a recuperar
500.000 blocos por solicitação.
operationId: getBlocksWithLimit
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
description: O nome do método RPC a ser invocado.
enum:
- getBlocksWithLimit
example: getBlocksWithLimit
default: getBlocksWithLimit
params:
type: array
description: Parâmetros de solicitação para o método.
default:
- 5
- 3
items:
type: object
properties:
start_slot:
type: integer
description: >-
Número do slot inicial Solana a partir do qual começar
a recuperar a lista de blocos sequenciais.
example: 5
limit:
type: integer
description: >-
Número máximo de blocos sequenciais a serem retornados
(até 500.000 blocos por solicitação).
example: 3
commitment:
type: string
description: >-
Nível de finalização para consultar os blocos - ou
confirmado (confirmação otimista) ou finalizado
(confirmação total).
enum:
- confirmed
- finalized
example: finalized
responses:
'200':
description: Blocos confirmados recuperados com sucesso.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
result:
type: array
description: >-
Lista ordenada de números de slots de bloco Solana
confirmados em sequência ascendente a partir do slot
solicitado.
items:
type: integer
example:
- 5
- 6
- 7
'400':
description: >-
Solicitação incorreta - 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: Invalid params
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: Unauthorized
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: Too many requests
id: '1'
'500':
description: Erro interno do servidor - Ocorreu um erro no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
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: Service unavailable
id: '1'
'504':
description: >-
Tempo limite do gateway - O tempo limite da solicitação foi
excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: O código de erro.
example: -32602
message:
type: string
description: A mensagem de erro.
data:
type: object
description: Dados adicionais sobre o erro.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API do Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````