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

# getBlocksWithLimit

> 주어진 슬롯에서 시작하는 확인된 블록 목록을 반환합니다.

## Request Parameters

<ParamField body="start_slot" type="number">
  연속적인 블록 목록을 검색할 시작 Solana 슬롯 번호입니다.
</ParamField>

<ParamField body="limit" type="number">
  반환할 최대 연속 블록 수 (요청당 최대 500,000 블록).
</ParamField>

<ParamField body="commitment" type="string">
  블록을 조회할 확정 수준 - 확인됨(낙관적 확인) 또는 완료됨(완전 확인).

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


## OpenAPI

````yaml ko/openapi/rpc-http/getBlocksWithLimit.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: Mainnet RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getBlocksWithLimit
      description: |
        사용자 정의 가능한 제한을 통해 특정 슬롯에서 시작하여 연속적인 Solana 블록 그룹을 검색합니다.
        이 블록체인 기록 API는 요청된 범위 내의 확인된 블록 슬롯 번호 배열을 반환하여
        역사적 블록을 효율적으로 페이지화할 수 있도록 합니다. 제한 매개변수 제어는
        대규모 블록체인 섹션을 스캔할 때 응답 크기와 성능을 관리하는 데 도움이 됩니다.
        블록체인 탐색기, 역사적 데이터 분석 도구, 트랜잭션 이력을 스캔하는 감사 시스템,
        인덱싱 서비스, 데이터 분석 플랫폼 및 메모리나 네트워크 제약 없이 연속적인 블록을 효율적으로 처리해야 하는
        애플리케이션에 필수적입니다. 요청당 500,000블록으로 제한됩니다.
      operationId: getBlocksWithLimit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              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:
                    - getBlocksWithLimit
                  example: getBlocksWithLimit
                  default: getBlocksWithLimit
                params:
                  type: array
                  description: 메서드에 대한 요청 매개변수입니다.
                  default:
                    - 5
                    - 3
                  items:
                    type: object
                    properties:
                      start_slot:
                        type: integer
                        description: 연속적인 블록 목록 검색을 시작할 시작 Solana 슬롯 번호입니다.
                        example: 5
                      limit:
                        type: integer
                        description: 반환할 연속 블록의 최대 개수입니다 (요청당 최대 500,000블록).
                        example: 3
                      commitment:
                        type: string
                        description: 블록을 조회할 완전성 수준 - 확인(낙관적 확인) 또는 완료(전체 확인) 중 하나입니다.
                        enum:
                          - confirmed
                          - finalized
                        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: array
                    description: 요청된 슬롯에서 시작하는 오름차순으로 정렬된 확인된 Solana 블록 슬롯 번호 목록입니다.
                    items:
                      type: integer
                    example:
                      - 5
                      - 6
                      - 7
        '400':
          description: 잘못된 요청 - 요청 매개변수가 잘못되었거나 요청이 잘못되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: 인증되지 않음 - API 키가 잘못되었거나 누락되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: 요청이 너무 많음 - 속도 제한 초과.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: 서비스를 사용할 수 없습니다 - 서비스가 일시적으로 사용 불가능합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '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 키입니다.
        [dashboard](https://dashboard.helius.dev/api-keys)에서 무료로 얻을 수 있습니다.

````