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

> SPL 토큰 유형의 총 공급량을 반환합니다.

## 요청 매개변수

<ParamField body="address" type="string" required>
  공급량 메트릭을 검색할 Solana 토큰 민트 주소(SPL 토큰의 고유 식별자)입니다.
</ParamField>

<ParamField body="commitment" type="string">
  요청에 대한 커밋 수준입니다.

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


## OpenAPI

````yaml ko/openapi/rpc-http/getTokenSupply.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: Solana 블록체인에서 모든 SPL 토큰이나 대체 가능한 자산의 현재 순환 및 총 공급 메트릭을 검색하는 토크노믹스 분석 API입니다.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: 개발자 네트워크 RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getTokenSupply
      description: >
        Solana 블록체인에서 모든 SPL 토큰에 대한 종합적인 토큰 공급 메트릭을 검색합니다.

        이 필수적인 토크노믹스 API는 토큰 순환 공급량, 총 발행량, 소수점 구성에 대한 정확하고 실시간 데이터를 제공합니다.

        토큰 분석 대시보드, DeFi 애플리케이션, 시가 총액 계산, 프로토콜 메트릭 및 신뢰할 수 있는 토큰 공급 정보를 필요로 하는
        트레이딩 플랫폼에 필수적입니다.

        정확한 표시를 위한 적절한 소수점 포맷의 모든 SPL 토큰 유형을 지원합니다.
      operationId: getTokenSupply
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: JSON-RPC 프로토콜 버전입니다.
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청을 위한 고유 식별자입니다.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getTokenSupply
                  description: 호출할 RPC 메소드의 이름입니다.
                  example: getTokenSupply
                  default: getTokenSupply
                params:
                  type: array
                  description: 토큰 공급을 쿼리하기 위한 매개변수입니다.
                  default:
                    - 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
                  items:
                    oneOf:
                      - type: string
                        description: 공급 메트릭을 검색하기 위한 Solana 토큰 민트 주소 (SPL 토큰의 고유 식별자).
                        example: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
                      - type: object
                        description: 구성 객체입니다.
                        properties:
                          commitment:
                            type: string
                            description: 요청에 대한 커밋 수준입니다.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
      responses:
        '200':
          description: 토큰 공급 정보가 성공적으로 검색되었습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC 프로토콜 버전입니다.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: 요청과 일치하는 식별자입니다.
                    example: '1'
                  result:
                    type: object
                    description: 컨텍스트 및 토큰 공급 세부 정보입니다.
                    properties:
                      context:
                        type: object
                        description: 응답의 컨텍스트입니다.
                        properties:
                          slot:
                            type: integer
                            description: 데이터가 가져온 슬롯입니다.
                            example: 1114
                      value:
                        type: object
                        description: 토큰 공급 세부 정보입니다.
                        properties:
                          amount:
                            type: string
                            description: 소수점 형식 없이 정밀한 정수 문자열로 표현된 순수한 Solana 토큰 총 공급량입니다.
                            example: '100000'
                          decimals:
                            type: integer
                            description: 정확한 공급 표현을 위한 토큰에 의해 정의된 소수 자릿수입니다.
                            example: 2
                          uiAmount:
                            type: number
                            description: 적절한 소수점 형식이 적용된 사람이 읽을 수 있는 토큰 공급량입니다 (사용 중단됨).
                            example: 1000
                          uiAmountString:
                            type: string
                            description: 정확한 소수점 자리를 가진 총 토큰 공급량의 표준 문자열 표현입니다.
                            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: 잘못된 요청 - 유효하지 않거나 잘못된 요청 매개변수입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: 유효하지 않은 매개변수입니다.
                id: '1'
        '401':
          description: 인증되지 않음 - 유효하지 않거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: 인증되지 않음
                id: '1'
        '429':
          description: 요청이 너무 많습니다 - 레이트 리밋 초과입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: 요청이 너무 많습니다.
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: 내부 오류
                id: '1'
        '503':
          description: 서비스 사용 불가 - 서비스가 일시적으로 사용 불가 상태입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: 서비스 사용 불가
                id: '1'
        '504':
          description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: 게이트웨이 시간 초과
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON-RPC 프로토콜 버전입니다.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: 오류 코드입니다.
              example: -32602
            message:
              type: string
              description: 오류 메시지입니다.
            data:
              type: object
              description: 오류에 대한 추가 데이터입니다.
        id:
          type: string
          description: 요청과 일치하는 식별자입니다.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        당신의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
        얻을 수 있습니다.

````