> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbscan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order Book Coverage

> Get the earliest and latest source timestamps stored for order book data.

Use this endpoint to find the time window covered by the order book data before you page through events. It returns the earliest and latest source timestamps across the whole table.

<Warning>
  These timestamps cover the full stored table. They do not guarantee that every timestamp or market is available through [Get Order Book Events](/api-reference/market/orderbook-events). The result is cached for 10 minutes.
</Warning>


## OpenAPI

````yaml openapi.json GET /v1/orderbook/coverage
openapi: 3.1.0
info:
  title: Orbscan Open API
  description: >-
    REST endpoints for Polymarket wallet activity, positions, transfers,
    transaction details, and L2 order book data.
  version: 1.0.0
servers:
  - url: https://api.orbscan.com
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/orderbook/coverage:
    get:
      summary: Get order book coverage
      description: >-
        Returns the earliest and latest source timestamps across the full stored
        order book table. These timestamps do not guarantee that every time or
        market is available through the events endpoint. The result is cached
        for 10 minutes.
      operationId: getOrderBookCoverage
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: OK
                  status_code:
                    type: string
                    example: '1'
                  data:
                    $ref: '#/components/schemas/OrderBookCoverage'
              example:
                message: OK
                status_code: '1'
                data:
                  polymarket:
                    orderbook:
                      availableFrom: 1788199076322
                      availableTo: 1790062682461
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
components:
  schemas:
    OrderBookCoverage:
      type: object
      properties:
        polymarket:
          type: object
          properties:
            orderbook:
              type: object
              properties:
                availableFrom:
                  type: integer
                  format: int64
                  description: >-
                    Earliest source timestamp across the order book table, Unix
                    milliseconds.
                availableTo:
                  type: integer
                  format: int64
                  description: >-
                    Latest source timestamp across the order book table, Unix
                    milliseconds.
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Missing or invalid API key
              status_code:
                type: string
                example: '0'
              data:
                type: 'null'
          example:
            message: Missing or invalid API key
            status_code: '0'
            data: null
    Forbidden:
      description: The API key is valid but not allowed to use this resource.
    TooManyRequests:
      description: The rate limit for your credential was exceeded.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Rate limit exceeded
              status_code:
                type: string
                example: '0'
              data:
                type: 'null'
          example:
            message: Rate limit exceeded
            status_code: '0'
            data: null
    ServerError:
      description: Unexpected server failure.
    ServiceUnavailable:
      description: Coverage is temporarily unavailable and no cached value can be returned.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Paste your Orbscan API key here. The `Bearer` prefix is added
        automatically.

````