AnyGas Account API

openapi: 3.2.0
info:
  title: Anygas Xyz Account 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 account 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: Account
  description: AnyGas Account — yield-native gasless spending, balances, receipts, and event webhooks for agents.
paths:
  /api/ncaccount/{agent}:
    get:
      tags:
      - Account
      summary: Non-custodial yield account
      description: 'The agent''s own Aave v3 / Moonwell position (aUSDC/mUSDC) per chain + the capped allowance it granted the relayer + live APY. Best-yield venue auto-selected. NON-CUSTODIAL: funds stay in the agent''s wallet; Robyn holds no key and no pool.'
      responses:
        '200':
          description: OK
      parameters:
      - name: agent
        in: path
        required: true
        schema:
          type: string
        description: the agent's own wallet address (0x…)
      operationId: getApiNcaccountByAgent
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/ncaccount/quote:
    post:
      tags:
      - Account
      summary: Quote a non-custodial yield spend
      description: 'Read-only JIT quote: how a spend would be fulfilled from the agent''s yield (draw ≤ allowance → Aave/Moonwell withdraw → gasless deliver). Body: {agent, srcChain, amount, toChain, toAddress}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiNcaccountQuote
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/ncaccount/spend:
    post:
      tags:
      - Account
      summary: Spend from yield (agent-signed)
      description: 'Execute a spend from the agent''s yield with ONE EIP-712 signature. Body: {intent:{agent,srcChain,amount,toChain,toAddress,nonce,deadline}, signature, live:true}. The relayer verifies the signature, pulls ONLY up to the agent''s on-chain aUSDC/mUSDC allowance, unwinds from the agent''s yield venue (Aave v3 or Moonwell), and delivers gaslessly. EIP-712 domain: {name:''RobynNCAccount'', version:''1'', chainId:srcChain}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiNcaccountSpend
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/account/{address}:
    get:
      tags:
      - Account
      summary: AnyGas Account (yield-aware balance)
      description: 'Unified yield-aware balance across chains: idle USDC + Aave v3 earning positions + blended APY + est. annual yield.'
      responses:
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM address (0x…)
      operationId: getApiAccountByAddress
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/account/venues:
    get:
      tags:
      - Account
      summary: Yield venues (live APYs)
      description: Live Aave v3 USDC supply APYs across supported chains (non-custodial — you hold the aToken).
      responses:
        '200':
          description: OK
      operationId: getApiAccountVenues
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/account/plan:
    post:
      tags:
      - Account
      summary: Plan a JIT payment from yield
      description: 'Cheapest-source JIT plan to deliver an amount to any chain from a yield position. Body: {from, toChain, amountUsd, toAddress}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiAccountPlan
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/account/gas:
    post:
      tags:
      - Account
      summary: Gas-on-demand from yield
      description: 'Quote delivering native gas to a chain, drawn just-in-time from the yield position. Body: {from, chain, amountUsd}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiAccountGas
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/balance/{address}:
    get:
      tags:
      - Account
      summary: Unified balance across all chains
      description: USDC balance for an address across every gasless chain — one wallet view.
      responses:
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM address (0x…)
      operationId: getApiBalanceByAddress
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/balance/plan:
    post:
      tags:
      - Account
      summary: Cheapest-source payment plan
      description: 'Plan the cheapest way to deliver an amount to any chain (same-chain gasless / best cross-chain source / split). Body: {from, toChain, toAddress, amountUsd}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiBalancePlan
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/receipts/{address}:
    get:
      tags:
      - Account
      summary: Signed execution receipts
      description: 'Relayer-signed, verifiable settlement history for an address (EIP-191). Verify: ethers.verifyMessage(receipt.digest, receipt.signature) === relayer.'
      responses:
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM address (0x…)
      operationId: getApiReceiptsByAddress
      x-operation-id-source: derived
    servers:
    - url: https://api.anygas.xyz/svc
      description: Production gateway (also https://anygas.xyz/svc)
  /api/events/subscribe:
    post:
      tags:
      - Account
      summary: Subscribe to price/balance webhooks
      description: 'HMAC-signed callback when a price or an address balance crosses a threshold. Body: {event:''price''|''balance'', url, secret?, ...filter}.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: OK
      operationId: postApiEventsSubscribe
      x-operation-id-source: derived
    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