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

# getEpochInfo

> 현재 epoch에 대한 정보를 반환합니다.

## 요청 매개변수

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

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

<ParamField body="minContextSlot" type="number">
  요청을 평가할 수 있는 최소 슬롯입니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/rpc-http/getEpochInfo.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    검증자 사이클 진행, 스테이킹 기간 및 블록체인 시간 메트릭 추적을 위한 포괄적인 Solana 에포크 모니터링 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: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getEpochInfo
      description: |
        현재 Solana 에포크, 검증자 사이클, 네트워크 진행에 대한 상세 정보를 검색합니다.
        이 필수 API는 현재 에포크 번호, 슬롯 진행,
        거래 수를 포함한 포괄적인 에포크 메트릭을 제공합니다. 에포크는 검증자 교체 사이클, 스테이킹 보상 기간 및
        Solana 블록체인의 시간 세분화를 나타냅니다. 스테이킹 애플리케이션, 보상 계산기,
        검증자 모니터링 도구 및 네트워크 진행 상황을 추적하거나 보상 분배, 프로토콜 업그레이드 등의
        에포크 기반 로직을 구현해야 하는 모든 애플리케이션에 중요합니다.
      operationId: getEpochInfo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  description: JSON-RPC 프로토콜 버전입니다.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청에 대한 고유 식별자입니다.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: 호출할 RPC 메서드의 이름입니다.
                  enum:
                    - getEpochInfo
                  example: getEpochInfo
                  default: getEpochInfo
                params:
                  type: array
                  description: 요청에 대한 선택적 매개변수입니다.
                  default: []
                  items:
                    type: object
                    properties:
                      commitment:
                        type: string
                        description: 요청에 대한 커밋 수준입니다.
                        enum:
                          - confirmed
                          - finalized
                        example: finalized
                      minContextSlot:
                        type: integer
                        description: 요청을 평가할 수 있는 최소 슬롯입니다.
                        example: 1000
      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
                    properties:
                      absoluteSlot:
                        type: integer
                        description: 전역 블록체인의 진행을 나타내는 현재 절대 Solana 슬롯 번호입니다.
                        example: 166598
                      blockHeight:
                        type: integer
                        description: 블록 단위로 Solana 블록체인의 현재 높이로, 전체 체인 성장을 추적하는 데 유용합니다.
                        example: 166500
                      epoch:
                        type: integer
                        description: 검증자 사이클 및 스테이킹 기간을 나타내는 현재 Solana 에포크 번호입니다.
                        example: 27
                      slotIndex:
                        type: integer
                        description: 에포크 내의 현재 위치로, 검증자 사이클을 통한 진행 상황을 보여줍니다.
                        example: 2790
                      slotsInEpoch:
                        type: integer
                        description: 현재 에포크의 총 슬롯 수로, 에포크 기간과 검증자 일정 길이를 정의합니다.
                        example: 8192
                      transactionCount:
                        type: integer
                        nullable: true
                        description: 생성 이래 Solana에서 처리된 성공적인 거래의 누적 개수입니다.
                        example: 22661093
              examples:
                default:
                  value:
                    jsonrpc: '2.0'
                    id: '1'
                    result:
                      absoluteSlot: 166598
                      blockHeight: 166500
                      epoch: 27
                      slotIndex: 2790
                      slotsInEpoch: 8192
                      transactionCount: 22661093
        '400':
          description: 잘못된 요청 - 잘못된 요청 매개변수 또는 형식이 잘못된 요청입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
        '401':
          description: 인증되지 않음 - 잘못되었거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
        '429':
          description: 요청이 너무 많음 - 속도 제한 초과.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
        '503':
          description: 서비스를 사용할 수 없음 - 서비스가 일시적으로 사용할 수 없습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
        '504':
          description: 게이트웨이 타임아웃 - 요청 시간이 초과되었습니다.
          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: 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: 오류에 대한 추가 데이터입니다.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: 당신의 Helius API 키입니다. 대시보드에서 무료로 얻을 수 있습니다.

````