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



## OpenAPI

````yaml /api-reference/stellar-aggregator-openapi.json get /api/v1/pools
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:
  /api/v1/pools:
    get:
      tags:
        - Discovery
      operationId: pools_handler
      responses:
        '200':
          description: Indexed pool catalog, grouped by contract
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PoolsResponse'
components:
  schemas:
    PoolsResponse:
      type: object
      required:
        - lastAppliedLedger
        - pools
      properties:
        lastAppliedLedger:
          type: integer
          format: int32
          description: Ledger applied through by this snapshot.
          minimum: 0
        pools:
          type: array
          items:
            $ref: '#/components/schemas/PoolEntry'
          description: >-
            Current indexed pools. Presence does not guarantee tradeable
            liquidity.
    PoolEntry:
      type: object
      required:
        - id
        - dex
        - assets
        - feeBps
      properties:
        assets:
          type: array
          items:
            type: string
          description: Constituent token contract identifiers, sorted by identifier.
        dex:
          type: string
          description: Indexed venue label.
        feeBps:
          type: integer
          format: int32
          description: Pool swap fee in basis points; excludes aggregator/referral fees.
          minimum: 0
        id:
          type: string
          description: Pool contract; multi-token swap edges are grouped into one entry.
        shareToken:
          type:
            - string
            - 'null'
          description: >-
            Non-null only when the snapshot supports this pool's liquidity
            position.

````

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