> ## 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
> Devuelve información de identidad y transacciones sobre un bloque confirmado en el libro mayor.
## Parámetros de la solicitud
Número de slot como entero `u64`.
El nivel de compromiso de la solicitud.
* `finalized`
El formato de codificación de cada transacción devuelta.
* `json`
* `jsonParsed`
* `base58`
* `base64`
Nivel de detalle de las transacciones que se devolverá. Si se solicitan cuentas, los detalles de las transacciones solo incluyen las firmas y una lista anotada de las cuentas de cada transacción. Los metadatos de las transacciones solo incluyen: fee, err, pre\_balances, post\_balances, pre\_token\_balances y post\_token\_balances.
* `full`
* `accounts`
* `signatures`
* `none`
Versión máxima de las transacciones que se devolverá en las respuestas. Configúrala en 1 para recibir transacciones heredadas, v0 y v1. Si el bloque solicitado contiene una transacción con una versión superior, se devuelve un error. Si se omite, solo se devuelven transacciones heredadas.
Indica si se debe completar el arreglo de recompensas.
## OpenAPI
````yaml es/openapi/rpc-http/getBlock.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API avanzada de recuperación de datos de bloques de Solana para acceder a
información completa de los bloques de la blockchain, incluidas
transacciones, firmas y recompensas, con niveles de detalle configurables.
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: getBlock
description: >
Recupera información detallada de un bloque de Solana para un número de
slot específico. Accede a los datos completos
del bloque, incluidas las transacciones, firmas, modificaciones de
cuentas, recompensas e información temporal.
Configura el nivel de detalle de las transacciones y el formato de
codificación para optimizarlos según las necesidades
específicas de tu aplicación.
operationId: getBlock
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- getBlock
description: El nombre del método RPC que se invocará.
default: getBlock
params:
type: array
description: Parámetros de la solicitud.
default:
- 430
items:
oneOf:
- type: integer
description: Número de slot como un entero `u64`.
example: 430
- type: object
description: >-
Opciones de configuración adicionales para la
solicitud.
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- finalized
default: finalized
encoding:
type: string
description: >-
El formato de codificación de cada transacción
devuelta.
enum:
- json
- jsonParsed
- base58
- base64
default: json
transactionDetails:
type: string
description: >-
Nivel de detalle de las transacciones que se
devolverá. Si se solicitan cuentas, los detalles
de las transacciones solo incluyen firmas y una
lista anotada de las cuentas de cada transacción.
Los metadatos de la transacción solo incluyen:
fee, err, pre_balances, post_balances,
pre_token_balances y post_token_balances.
enum:
- full
- accounts
- signatures
- none
default: full
maxSupportedTransactionVersion:
type: integer
description: >-
Versión máxima de transacción que se devolverá en
las respuestas. Establécela en 1 para recibir
transacciones heredadas, v0 y v1. Si el bloque
solicitado contiene una transacción con una
versión superior, se devuelve un error. Si se
omite, solo se devuelven transacciones heredadas.
example: 1
rewards:
type: boolean
description: >-
Indica si se debe completar el arreglo de
recompensas.
default: true
responses:
'200':
description: Los detalles del bloque se recuperaron correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
type: string
result:
type: object
properties:
blockhash:
type: string
description: El hash de este bloque (cadena codificada en base 58).
example: DUCT8VSgk2BXkMhQfxKVYfikEZCQf4dZ4ioPdGdaVxMN
previousBlockhash:
type: string
description: El hash del bloque principal de este bloque.
example: HA2fJgGqmQezCXJRVNZAWPbRMXCPjUyo7VjRF47JGdYs
parentSlot:
type: integer
description: El índice del slot principal de este bloque.
example: 429
transactions:
type: array
description: Arreglo de detalles de transacciones.
items:
type: object
properties:
meta:
type: object
nullable: true
description: Metadatos asociados con la transacción.
transaction:
type: object
description: Detalles de la transacción.
properties:
message:
type: object
properties:
accountKeys:
type: array
description: >-
Arreglo de claves públicas de cuentas
utilizadas en esta transacción.
items:
type: string
header:
type: object
properties:
numReadonlySignedAccounts:
type: integer
description: >-
Número de cuentas firmadas de solo
lectura.
numReadonlyUnsignedAccounts:
type: integer
description: >-
Número de cuentas sin firmar de solo
lectura.
numRequiredSignatures:
type: integer
description: Número de firmas requeridas.
instructions:
type: array
description: Arreglo de instrucciones del programa.
items:
type: object
properties:
accounts:
type: array
description: Arreglo de índices de cuentas.
items:
type: integer
data:
type: string
description: >-
Datos de entrada del programa
codificados en base58.
programIdIndex:
type: integer
description: >-
Índice del ID del programa en el arreglo
accountKeys.
stackHeight:
type: integer
nullable: true
description: Altura de la pila.
recentBlockhash:
type: string
description: >-
Hash de bloque reciente utilizado en
esta transacción.
signatures:
type: array
description: >-
Arreglo de firmas de esta transacción
(codificadas en base 58).
items:
type: string
blockTime:
type: integer
nullable: true
description: >-
Tiempo estimado de producción como marca de tiempo
Unix.
example: null
blockHeight:
type: integer
nullable: true
description: Número de bloques debajo de este bloque.
example: null
rewards:
type: array
description: Recompensas del bloque.
items:
type: object
properties:
pubkey:
type: string
description: >-
La clave pública de la cuenta que recibió la
recompensa.
lamports:
type: integer
description: >-
Número de lamports de recompensa acreditados o
debitados.
rewardType:
type: string
nullable: true
description: Tipo de recompensa (p. ej., "fee", "rent").
'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: la clave de API no es válida o no se proporcionó.'
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: ocurrió 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
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
message:
type: string
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).
````