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

> Возвращает список подтвержденных блоков, начиная с указанного слота.

## Параметры запроса

<ParamField body="start_slot" type="number">
  Номер начального слота Solana, с которого следует начать получение последовательного списка блоков.
</ParamField>

<ParamField body="limit" type="number">
  Максимальное количество последовательных блоков, возвращаемых в ответе (до 500 000 блоков на запрос).
</ParamField>

<ParamField body="commitment" type="string">
  Уровень финализации для запроса блоков: confirmed (оптимистическое подтверждение) или finalized (полное подтверждение).

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


## OpenAPI

````yaml ru/openapi/rpc-http/getBlocksWithLimit.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API истории блокчейна для получения последовательных слотов блоков Solana в
    указанном диапазоне с настраиваемым ограничением для оптимизации объема
    данных и производительности запросов.
  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 сети Devnet
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: >-
                          Уровень финализации блоков для запроса: confirmed
                          (оптимистическое подтверждение) или finalized (полное
                          подтверждение).
                        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: >-
        Ваш ключ API Helius. Его можно получить бесплатно в [панели
        управления](https://dashboard.helius.dev/api-keys).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.