AnyGas Floatlane API

openapi: 3.2.0
info:
  title: Anygas Xyz Floatlane API
  version: 3.28.2
  contact:
    name: Robyn AnyGas
    url: https://anygas.xyz
  license:
    name: Service terms
    url: https://anygas.xyz/svc/api/terms
  x-lastUpdated: '2026-07-29'
  description: 'Operations tagged floatlane across 2 of this provider''s published API definitions: anygas-openapi.json, anygas-xyz-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.anygas.xyz/svc
  description: Production gateway (also https://anygas.xyz/svc)
tags:
- name: floatlane
paths:
  /api/floatlane/pending:
    get:
      tags:
      - floatlane
      summary: Unfinished payouts (should always be empty)
      description: 'Obligations where a user has paid in but the payout has not completed — normally an empty object. A pending row is written BEFORE each payout so a crash between taking custody and paying out cannot lose the obligation; a keeper reconciles anything left behind every five minutes. Published for transparency: you can verify at any time that nothing is owed.'
      operationId: getFloatlanePending
      responses:
        '200':
          description: Map of unfinished obligations, keyed by id
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/floatlane/transfers:
    get:
      tags:
      - floatlane
      summary: Float-lane transfer history, independently verifiable
      description: Recent float-lane settlements. Pass ?verify=1 to re-read each payout on-chain and confirm the delivered amount equals what the quote promised. Destination transaction hashes are published only for our own self-funded payouts, never for user transfers.
      operationId: getFloatlaneTransfers
      parameters:
      - name: verify
        in: query
        required: false
        description: Set to 1 to re-check each payout against the chain.
        schema:
          type: string
          enum:
          - '1'
      responses:
        '200':
          description: Transfer list, optionally with on-chain verification
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/floatlane/reconcile:
    post:
      tags:
      - floatlane
      summary: Complete unfinished payouts (owner-gated)
      description: 'Heals the crash-safety net. For each unfinished obligation it decides safely: if the recipient balance already rose by the payout amount the payout landed and the row is cleared; if the balance is provably unchanged the payout never happened and can be completed; anything ambiguous is left pending for manual review, so it can never double-pay. Obligations younger than ten minutes are skipped because their payout may still be broadcasting. Requires the owner key; DRY unless {"live":true}. A keeper runs this automatically every five minutes.'
      operationId: postFloatlaneReconcile
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                live:
                  type: boolean
                  description: false (default) decides and reports without moving funds.
      responses:
        '200':
          description: Per-obligation outcomes
          content:
            application/json:
              schema:
                type: object
        '401':
          description: Owner key required
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
x-refined-from:
- anygas-openapi.json
- anygas-xyz-openapi.json