> ## 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.
# getTokenSupply
> Retorna o fornecimento total de um tipo de Token SPL.
## Parâmetros da Solicitação
Endereço de cunhagem do token Solana para recuperar métricas de fornecimento (identificador único do token SPL).
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getTokenSupply.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de análise de tokenomics para recuperar métricas de circulação atual e
fornecimento total para qualquer token SPL ou ativo fungível na blockchain
Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Ponto de extremidade RPC do Mainnet
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade RPC do Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTokenSupply
description: >
Recuperar métricas abrangentes de fornecimento de token para qualquer
token SPL na blockchain Solana.
Esta API de tokenomics essencial fornece dados precisos e em tempo real
sobre a circulação
do token, quantidade total de emissão e configuração decimal. Crítico
para dashboards de análise de
tokens, aplicações DeFi, cálculos de market cap, métricas de protocolo e
plataformas de negociação que precisam
de informações confiáveis sobre fornecimento de tokens. Suporta todos os
tipos de tokens SPL, incluindo tokens fungíveis e
tokens comunitários com formatação decimal adequada para exibição
precisa.
operationId: getTokenSupply
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- getTokenSupply
description: O nome do método RPC a ser invocado.
example: getTokenSupply
default: getTokenSupply
params:
type: array
description: Parâmetros para consultar o fornecimento do token.
default:
- 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
items:
oneOf:
- type: string
description: >-
Endereço de cunhagem do token Solana para recuperar
métricas de fornecimento (identificador único do token
SPL).
example: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
- type: object
description: Objeto de configuração.
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
- processed
example: finalized
responses:
'200':
description: Fornecimento do token recuperado 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: object
description: Contexto e detalhes do fornecimento do token.
properties:
context:
type: object
description: Contexto da resposta.
properties:
slot:
type: integer
description: Slot no qual os dados foram buscados.
example: 1114
value:
type: object
description: Detalhes do fornecimento do token.
properties:
amount:
type: string
description: >-
O fornecimento total de token Solana bruto como
uma string de número inteiro precisa sem
formatação decimal.
example: '100000'
decimals:
type: integer
description: >-
Número de casas decimais definido pelo token para
representação precisa do fornecimento.
example: 2
uiAmount:
type: number
description: >-
O fornecimento de token em formato legível com
formatação decimal adequada (descontinuado).
example: 1000
uiAmountString:
type: string
description: >-
A representação em string canônica do fornecimento
total do token com casas decimais corretas.
example: '1000'
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 1114
value:
amount: '100000'
decimals: 2
uiAmount: 1000
uiAmountString: '1000'
'400':
description: >-
Bad Request - 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: Unauthorized - 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: Too Many Requests - 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: Internal Server Error - 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: Service Unavailable - 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: Gateway Timeout - A solicitação expirou.
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.
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[painel](https://dashboard.helius.dev/api-keys).
````