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

> ## Agent Instructions
> Rail402 is an x402 payment facilitator, Stellar-native Bazaar discovery layer, and agent tooling for the Stellar network. It currently targets stellar:testnet.
> The live testnet facilitator is https://facilitator.rail402.dev with endpoints /verify, /settle, /supported, /health, and /discovery/*.
> Payment amounts use 7-decimal SEP-41 integer (stroop) arithmetic. Never use floating-point math for amounts.
> Every rejection returns a machine-readable error code and a non-null human-readable reason. When explaining a failure, surface both.

# Prometheus metrics



## OpenAPI

````yaml /api-reference/facilitator.openapi.yaml get /metrics
openapi: 3.1.0
info:
  title: Rail402 Facilitator API
  version: '2.0'
  license:
    name: Apache-2.0
    identifier: Apache-2.0
  description: >
    The Rail402 x402 facilitator and Bazaar discovery layer on
    `stellar:testnet`.

    Verify and settle x402 payments, read what the facilitator supports, and
    browse or

    search the discovery catalog. Speaks the x402 v2 wire format, so a stock
    `@x402` client

    interoperates with no Rail402-specific code.


    Amounts are integer strings in atomic units at 7 decimals: one USDC is
    `10000000`, so

    `500000` is 0.05 USDC. Every rejection carries a machine `code`, a non-null
    `reason`, and a

    `retryable` flag.
servers:
  - url: https://facilitator.rail402.dev
    description: stellar:testnet
security: []
tags:
  - name: Payments
    description: Verify and settle payments
  - name: Discovery
    description: Browse and search the Bazaar catalog
  - name: Info
    description: Capabilities, health, and metrics
paths:
  /metrics:
    get:
      tags:
        - Info
      summary: Prometheus metrics
      operationId: getMetrics
      responses:
        '200':
          description: Prometheus text. Aggregate counters only, with no per-caller labels.
          content:
            text/plain:
              schema:
                type: string

````