> ## 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.
# getSupply
> getSupply devuelve el suministro actual de SOL en Solana — las cantidades totales, circulantes y no circulantes en lamports, con cuentas de reserva no circulantes opcionales.
## Parámetros de la solicitud
El nivel de compromiso de la solicitud.
* `confirmed`
* `finalized`
* `processed`
Opción para excluir la lista detallada de cuentas de reserva de SOL no circulante y obtener una respuesta más rápida.
## OpenAPI
````yaml es/openapi/rpc-http/getSupply.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API de análisis del suministro de SOL nativo para monitorear la circulación
total, la economía del token y las métricas de distribución en todo el
ecosistema de la blockchain de Solana.
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 la red principal
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de la red de desarrollo
security: []
paths:
/:
post:
tags:
- RPC
summary: getSupply
description: >
Obtén métricas completas sobre el suministro y la distribución del token
SOL nativo de Solana.
Esta API esencial de economía de tokens proporciona desgloses detallados
del suministro de tokens en circulación y fuera de circulación, lo que
ayuda a dar seguimiento a la distribución de SOL en todo el ecosistema.
Los datos incluyen el suministro total de SOL, las cifras de circulación
activa, los tokens en reserva y una lista de las cuentas que mantienen
tokens fuera de circulación. Es fundamental para analistas financieros,
investigadores de economía de tokens, rastreadores de mercado y
aplicaciones que necesitan métricas precisas sobre el suministro y los
patrones de distribución del token nativo de Solana.
operationId: getSupply
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- getSupply
description: El nombre del método RPC que se invocará.
example: getSupply
default: getSupply
params:
type: array
description: Objeto de configuración opcional.
default: []
items:
type: object
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
excludeNonCirculatingAccountsList:
type: boolean
description: >-
Opción para excluir la lista detallada de cuentas de
reserva de SOL fuera de circulación y obtener una
respuesta más rápida.
example: true
responses:
'200':
description: La información del suministro se obtuvo 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: object
description: Contexto y detalles del suministro.
properties:
context:
type: object
description: Contexto de la respuesta.
properties:
slot:
type: integer
description: Slot en el que se obtuvieron los datos.
example: 1114
value:
type: object
description: Detalles del suministro.
properties:
total:
type: integer
description: >-
Suministro total de SOL existente (en lamports),
incluidos los tokens en circulación y bloqueados.
example: 1016000
circulating:
type: integer
description: >-
Cantidad de SOL (en lamports) actualmente en
circulación y disponible para uso público.
example: 16000
nonCirculating:
type: integer
description: >-
Cantidad de SOL (en lamports) almacenada en
cuentas de reserva y que no está disponible
actualmente en circulación.
example: 1000000
nonCirculatingAccounts:
type: array
description: >-
Lista de direcciones de billeteras de Solana que
mantienen tokens SOL fuera de circulación en
reserva.
items:
type: string
example:
- FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
- 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
- 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
- BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
examples:
default:
$ref: '#/components/examples/getSupplyResponse'
'400':
description: >-
Solicitud incorrecta: los parámetros de la solicitud no son válidos
o la solicitud tiene un 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:
examples:
getSupplyResponse:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 1114
value:
total: 1016000
circulating: 16000
nonCirculating: 1000000
nonCirculatingAccounts:
- FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
- 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
- 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
- BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
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 de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
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).
````