AnyGas Netting API

openapi: 3.2.0
info:
  title: Anygas Xyz Netting 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 netting 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: netting
paths:
  /api/netting/info:
    get:
      tags:
      - netting
      summary: What netting is, and what you are accepting
      description: 'Describes the opt-in custodial balance product: free instant transfers between enrolled accounts, the caps, the fee model (zero for internal transfers) and the alternative if you do not want custody. NOTE: netting is the ONE custodial part of this service. Every other rail holds nothing on your behalf.'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      operationId: getApiNettingInfo
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/terms:
    get:
      tags:
      - netting
      summary: The exact consent text you must sign to enrol
      description: 'Returns the message an account must sign with its OWN key to open a custodial netting balance. Signing it is the record of informed consent; enrolment without a valid signature is refused. NOTE: netting is the ONE custodial part of this service. Every other rail holds nothing on your behalf.'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: address
        in: query
        required: true
        schema:
          type: string
      operationId: getApiNettingTerms
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/enroll:
    post:
      tags:
      - netting
      summary: Open a custodial netting account
      description: 'Body {address, signature}. The signature must recover to the address, so nobody can enrol an account they do not control. Call GET /api/netting/terms first for the text to sign. NOTE: netting is the ONE custodial part of this service. Every other rail holds nothing on your behalf.'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - address
              - signature
              properties:
                address:
                  type: string
                signature:
                  type: string
      operationId: postApiNettingEnroll
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/account:
    get:
      tags:
      - netting
      summary: Balance, enrolment state and next nonce
      description: Reports whether the address is enrolled (and therefore custodied), its internal balance, the recent journal, and nextNonce for signing the next transfer or withdrawal.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      parameters:
      - name: address
        in: query
        required: true
        schema:
          type: string
      operationId: getApiNettingAccount
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/transfer:
    post:
      tags:
      - netting
      summary: Free internal transfer (no chain touched)
      description: 'Moves value between two enrolled accounts as a book entry: no gas, no bridge, no fee, and NO transaction hash because no transaction occurs. Both parties must be enrolled — we will not hold a balance for a recipient who never consented. Sign robyn-netting-transfer:v1:from=…:to=…:amount=…:nonce=… with the sender key. Nonces are monotonic, so a captured signature cannot be replayed.'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - from
              - to
              - amount
              - nonce
              - signature
              properties:
                from:
                  type: string
                to:
                  type: string
                amount:
                  type: string
                nonce:
                  type: string
                signature:
                  type: string
      operationId: postApiNettingTransfer
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/deposit:
    post:
      tags:
      - netting
      summary: Credit a netting balance from a real on-chain transfer
      description: Send USDC to the relayer on any covered chain, then present {address, chainId, txHash}. The credit is derived from the Transfer events in that receipt, so only what actually arrived is credited, and only to the account that actually sent it. Each transaction can be credited once.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - address
              - chainId
              - txHash
              properties:
                address:
                  type: string
                chainId:
                  type: integer
                txHash:
                  type: string
      operationId: postApiNettingDeposit
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/withdraw:
    post:
      tags:
      - netting
      summary: Settle a netting balance back on-chain
      description: Debits the internal balance and pays out real USDC on the chosen chain. The debit happens BEFORE the payout so a crash can never pay twice; if the payout fails the balance is restored and journalled. Sign robyn-netting-withdraw:v1:account=…:amount=…:toChain=…:toAddress=…:nonce=…
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - address
              - amount
              - toChain
              - nonce
              - signature
              properties:
                address:
                  type: string
                amount:
                  type: string
                toChain:
                  type: integer
                toAddress:
                  type: string
                nonce:
                  type: string
                signature:
                  type: string
      operationId: postApiNettingWithdraw
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/reserves:
    get:
      tags:
      - netting
      summary: 'Proof of reserves: liabilities vs backing float'
      description: Publishes total custodied liabilities against the relayer USDC float backing them, broken down per chain, so solvency can be checked by anyone rather than taken on trust. Deposits are refused if they would push liabilities above a safe share of that float.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      operationId: getApiNettingReserves
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/netting/preview:
    get:
      tags:
      - netting
      summary: What a withdrawal would actually deliver, before you sign
      description: Free, read-only. Given an amount, returns the exit cost and the net delivered amount for every chain, ranked best-first — exit costs differ by more than 1000x, so which chain you leave on is a real decision. Pass toChain to price one chain and learn whether it would succeed at all. Internal transfers between netting accounts are free at any size; this cost applies only when leaving for a real on-chain balance.
      operationId: getNettingPreview
      parameters:
      - name: amount
        in: query
        required: true
        schema:
          type: string
        description: Amount in USDC base units (6dp), e.g. "1000000" for $1.00.
      - name: toChain
        in: query
        required: false
        schema:
          type: integer
        description: Price a single chain instead of ranking them all.
      responses:
        '200':
          description: Exit costs and delivered amounts
          content:
            application/json:
              schema:
                type: object
    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