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

# Get runtime events

> Returns recent runtime events in chronological order, optionally limited to the newest events.



## OpenAPI

````yaml /openapi.yaml get /v1/runtime/events
openapi: 3.1.0
info:
  title: Firmament Backend API
  version: 0.1.3
  summary: Public backend routes for Firmament swaps and runtime proof.
  description: >
    Firmament is a Solana RFQ maker backend for managed liquidity demos.

    This specification documents the public routes used by the swap app and
    runtime view.
servers:
  - url: https://api.firmament.shaikazeem.com
    description: Deployed Firmament API.
  - url: http://127.0.0.1:5050
    description: Local backend started with `cargo run`.
security: []
tags:
  - name: Health
    description: Runtime liveness.
  - name: Assets
    description: Supported Solana assets.
  - name: Pairs
    description: Configured directional pairs and constraints.
  - name: RFQ
    description: Firm quote requests.
  - name: Settlement
    description: Browser-wallet HTLC settlement.
  - name: Trades
    description: Trade status lookup.
  - name: Runtime
    description: Read-only runtime state, events, ledger, and trades.
paths:
  /v1/runtime/events:
    get:
      tags:
        - Runtime
      summary: Get runtime events
      description: >-
        Returns recent runtime events in chronological order, optionally limited
        to the newest events.
      operationId: getRuntimeEvents
      parameters:
        - name: limit
          in: query
          required: false
          description: Maximum number of newest events to return.
          schema:
            type: integer
            minimum: 1
            example: 30
      responses:
        '200':
          description: Recent runtime events.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeEventsResponse'
components:
  schemas:
    RuntimeEventsResponse:
      type: object
      required:
        - count
        - events
      properties:
        count:
          type: integer
          minimum: 0
        events:
          type: array
          items:
            $ref: '#/components/schemas/RuntimeEvent'
    RuntimeEvent:
      type: object
      required:
        - category
        - event
      properties:
        category:
          type: string
          enum:
            - quote
            - settlement
            - swap
            - gateway
            - risk
            - inventory
            - reconciliation
            - system
        event:
          type: object
          additionalProperties: true
          description: Event payload. Shape depends on the category and event type.

````