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

# Get ready



## OpenAPI

````yaml /api-reference/stellar-aggregator-openapi.json get /ready
openapi: 3.1.0
info:
  title: Stellar DEX Aggregator API
  description: >-
    Soroban DEX aggregator and routing engine for Stellar. Bounded multi-DEX
    routing across Soroban venues: Soroswap, Aquarius, Phoenix, Sushi, and
    Comet.


    ## Features

    - Forward & reverse quotes (given input → output, or target output → input)

    - Multi-path split allocation across pools to minimize price impact

    - Optional server-side simulated `TransactionEnvelope` requiring account
    sequence and signature

    - Auto-fallback when the on-chain budget rejects the requested config

    - Echoes USD value + protocol/referral fees
  license:
    name: MIT
    identifier: MIT
  version: 0.1.0
servers:
  - url: https://stellar-swap.xoxno.com
    description: Public deployment; verify network with /api/v1/config
security: []
tags:
  - name: Discovery
    description: Deployment, pools and referral fee policy
  - name: Health
    description: Liveness and readiness probes
  - name: Tokens
    description: Routable token catalog
  - name: Quote
    description: Routing, quoting, and transaction-envelope construction
paths:
  /ready:
    get:
      tags:
        - Health
      operationId: ready_handler
      responses:
        '200':
          description: Snapshot is fresh — quotes will reflect current pool state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadyResponse'
        '503':
          description: >-
            Snapshot has not advanced within the staleness threshold (RPC down
            or network silent)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReadyResponse'
components:
  schemas:
    ReadyResponse:
      type: object
      description: Snapshot freshness readiness gate.
      required:
        - ready
        - seconds_since_last_apply
        - staleness_threshold_secs
        - last_applied_ledger
        - pools
      properties:
        last_applied_ledger:
          type: integer
          format: int32
          description: Last ledger applied through by the snapshot.
          minimum: 0
        pools:
          type: integer
          description: Indexed swap edges, not distinct pool contracts.
          minimum: 0
        ready:
          type: boolean
          description: True when snapshot age is within the threshold.
        seconds_since_last_apply:
          type: integer
          format: int64
          description: Seconds since the snapshot last advanced.
          minimum: 0
        staleness_threshold_secs:
          type: integer
          format: int64
          description: Maximum accepted snapshot age in seconds.
          minimum: 0

````

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