> ## 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
> Devuelve una lista de bloques confirmados a partir del slot especificado.
## Parámetros de la solicitud
Número de slot inicial de Solana desde el cual se comienza a recuperar la lista secuencial de bloques.
Número máximo de bloques secuenciales que se devolverán (hasta 500,000 bloques por solicitud).
Nivel de finalidad con el que se consultarán los bloques: confirmed (confirmación optimista) o finalized (confirmación completa).
* `confirmed`
* `finalized`
## OpenAPI
````yaml es/openapi/rpc-http/getBlocksWithLimit.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API de historial de blockchain para recuperar slots de bloques secuenciales
de Solana dentro de un rango especificado, con controles de límite
personalizables para optimizar el volumen de datos y el rendimiento de las
consultas.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getBlocksWithLimit
description: >
Recupera una secuencia contigua de bloques de Solana a partir de un slot
específico, con un límite personalizable.
Esta API de historial de blockchain devuelve un arreglo de números de
slot de bloques confirmados dentro del rango solicitado,
lo que permite paginar de manera eficiente los bloques históricos. El
parámetro de límite controlado ayuda a administrar
el tamaño de la respuesta y el rendimiento al examinar grandes secciones
de la blockchain. Es esencial para exploradores
de blockchain, herramientas de análisis de datos históricos, sistemas de
auditoría que examinan el historial de transacciones, servicios de
indexación,
plataformas de análisis de datos y aplicaciones que necesitan procesar
bloques secuenciales de manera eficiente sin
sobrepasar las restricciones de memoria o red. Se limita a recuperar
500,000 bloques por solicitud.
operationId: getBlocksWithLimit
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
description: El nombre del método RPC que se invocará.
enum:
- getBlocksWithLimit
example: getBlocksWithLimit
default: getBlocksWithLimit
params:
type: array
description: Parámetros de solicitud para el método.
default:
- 5
- 3
items:
type: object
properties:
start_slot:
type: integer
description: >-
Número de slot inicial de Solana desde el cual se
comenzará a recuperar la lista secuencial de bloques.
example: 5
limit:
type: integer
description: >-
Número máximo de bloques secuenciales que se
devolverán (hasta 500,000 bloques por solicitud).
example: 3
commitment:
type: string
description: >-
Nivel de finalidad con el que se consultarán los
bloques: confirmed (confirmación optimista) o
finalized (confirmación completa).
enum:
- confirmed
- finalized
example: finalized
responses:
'200':
description: Los bloques confirmados se recuperaron correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: array
description: >-
Lista ordenada de números de slot de bloques confirmados
de Solana en secuencia ascendente a partir del slot
solicitado.
items:
type: integer
example:
- 5
- 6
- 7
'400':
description: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Parámetros no válidos
id: '1'
'401':
description: 'No autorizado: clave de API no válida o ausente.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: No autorizado
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Demasiadas solicitudes
id: '1'
'500':
description: 'Error interno del servidor: se produjo un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Error interno
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Servicio no disponible
id: '1'
'504':
description: >-
Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
de espera de la solicitud.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tiempo de espera de la puerta de enlace agotado
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código del error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````