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

# Advisory agent escrow status

> Escrow balance, committed spend, and quoted next round price.



## OpenAPI

````yaml gateway-openapi.yaml GET /v1/agent/{payer}/status
openapi: 3.1.0
info:
  contact: {}
  description: HTTP entry point to the Molpha oracle protocol.
  title: Molpha Gateway API
  version: '1.0'
  x-mint:
    metadata:
      description: >-
        Dispatch oracle rounds, collect threshold signatures, and return
        payloads for Solana, EVM, and Starknet verification.
servers:
  - url: https://dev-gateway.molpha.io
    description: Devnet (SDK default)
security: []
tags:
  - name: health
    x-group: Health
    description: Liveness probes
  - name: nodes
    x-group: Nodes
    description: Oracle node discovery
  - name: round
    x-group: Subscription rounds
    description: Subscription and delegate execute path
  - name: agent
    x-group: Agent (x402)
    description: Pay-per-request agent path (requires `agent.enabled`)
paths:
  /v1/agent/{payer}/status:
    get:
      tags:
        - agent
      summary: Advisory agent escrow status
      description: Escrow balance, committed spend, and quoted next round price.
      parameters:
        - name: payer
          in: path
          required: true
          description: Payer identity (base58 Ed25519 pubkey)
          schema:
            type: string
            example: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
        - name: signatures_required
          in: query
          description: Quorum used for the price quote
          schema:
            type: integer
            default: 1
            example: 3
      responses:
        '200':
          description: Escrow status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentEscrowStatus'
              example:
                payer: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
                gateway: GwPDA1111111111111111111111111111111111111
                escrow: EscrowPDA1111111111111111111111111111111111
                exists: true
                authority: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
                status: Active
                ataAddress: Ata1111111111111111111111111111111111111
                ataExists: true
                ataBalance: '2060'
                committedAmount: '1030'
                quotedNextPrice: '1030'
                unsettledRounds: 1
        '400':
          description: Invalid payer pubkey
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    AgentEscrowStatus:
      type: object
      description: Advisory on-chain escrow state for one payer at this gateway.
      properties:
        payer:
          type: string
          description: Payer pubkey (base58).
        gateway:
          type: string
          description: Settling gateway PDA (base58).
        escrow:
          type: string
          description: Agent escrow PDA derived from `(payer, gateway)`.
        exists:
          type: boolean
          description: Whether the escrow account has been created on-chain.
        authority:
          type: string
          description: Ed25519 signer authorized to submit agent rounds.
        status:
          type: string
          description: Escrow status (`Active` or `Paused`).
          example: Active
        ataAddress:
          type: string
          description: USDC associated token account for the escrow PDA.
        ataExists:
          type: boolean
          description: Whether the escrow ATA has been created.
        ataBalance:
          type: string
          description: Total USDC balance in the ATA (atomic units, decimal string).
          example: '2060'
        committedAmount:
          type: string
          description: USDC reserved by unsettled rounds (atomic units, decimal string).
          example: '1030'
        quotedNextPrice:
          type: string
          description: Price for the next round at the requested quorum (atomic units).
          example: '1030'
        unsettledRounds:
          type: integer
          description: Count of served rounds awaiting on-chain settlement.
          example: 1
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
          example: validation failed

````