> ## 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

> Retorna informações sobre o fornecimento atual.

## Parâmetros da Requisição

<ParamField body="commitment" type="string">
  O nível de compromisso para a requisição.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>

<ParamField body="excludeNonCirculatingAccountsList" type="boolean">
  Opção para excluir a lista detalhada de contas de reserva SOL não circulantes para uma resposta mais rápida.
</ParamField>


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getSupply.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de análise de fornecimento nativo de SOL para monitorar a circulação
    total, economia de tokens e métricas de distribuição em todo o ecossistema
    da 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: Endpoint RPC da Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC da Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getSupply
      description: >
        Recupere métricas abrangentes sobre o fornecimento e distribuição do
        token SOL nativo da Solana.

        Esta API de tokenomics essencial proporciona desmembramentos detalhados
        do fornecimento

        de tokens circulantes e não circulantes, ajudando a rastrear a
        distribuição de SOL no

        ecosistema. Os dados incluem o fornecimento total de SOL, números de
        circulação ativa,

        tokens em reserva e uma lista de contas que mantêm tokens não
        circulantes. Crítico para

        analistas financeiros, pesquisadores de economia de tokens, rastreadores
        de mercado e

        aplicações que precisam de métricas precisas sobre o fornecimento e
        padrões de distribuição

        do token nativo da Solana.
      operationId: getSupply
      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:
                    - getSupply
                  description: O nome do método RPC a ser invocado.
                  example: getSupply
                  default: getSupply
                params:
                  type: array
                  description: Objeto de configuração opcional.
                  default: []
                  items:
                    type: object
                    properties:
                      commitment:
                        type: string
                        description: O nível de compromisso para a solicitação.
                        enum:
                          - confirmed
                          - finalized
                          - processed
                        example: finalized
                      excludeNonCirculatingAccountsList:
                        type: boolean
                        description: >-
                          Opção para excluir a lista detalhada de contas de
                          reserva de SOL não circulantes para uma resposta mais
                          rápida.
                        example: true
      responses:
        '200':
          description: Informações de fornecimento recuperadas 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 que corresponde à solicitação.
                    example: '1'
                  result:
                    type: object
                    description: Detalhes do contexto e fornecimento.
                    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.
                        properties:
                          total:
                            type: integer
                            description: >-
                              Fornecimento total de SOL em existência (em
                              lamports), incluindo tokens circulantes e
                              bloqueados.
                            example: 1016000
                          circulating:
                            type: integer
                            description: >-
                              Quantidade de SOL (em lamports) atualmente em
                              circulação e disponível para uso público.
                            example: 16000
                          nonCirculating:
                            type: integer
                            description: >-
                              Quantidade de SOL (em lamports) mantida em contas
                              de reserva e não disponível atualmente em
                              circulação.
                            example: 1000000
                          nonCirculatingAccounts:
                            type: array
                            description: >-
                              Lista de endereços de carteiras Solana que detêm
                              tokens SOL não circulantes em reserva.
                            items:
                              type: string
                            example:
                              - FEy8pTbP5fEoqMV1GdTz83byuA8EKByqYat1PKDgVAq5
                              - 9huDUZfxoJ7wGMTffUE7vh1xePqef7gyrLJu9NApncqA
                              - 3mi1GmwEE3zo2jmfDuzvjSX9ovRXsDUKHvsntpkhuLJ9
                              - BYxEJTDerkaRWBem3XgnVcdhppktBXa2HbkHPKj2Ui4Z
              examples:
                default:
                  $ref: '#/components/examples/getSupplyResponse'
        '400':
          description: >-
            Requisição Inválida - 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: Parâmetros inválidos
                id: '1'
        '401':
          description: Não Autorizado - Chave API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Não autorizado
                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: Muitas solicitações
                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: Erro interno
                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: Serviço indisponível
                id: '1'
        '504':
          description: Tempo de Espera do Gateway Esgotado - A solicitação expirou.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tempo de espera esgotado
                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: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código do 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 que corresponde à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave API da Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````