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

# Quote Somnia payment requirements

> Returns exact STT payment requirements for a registered Somnia agent without requesting the protected resource.



## OpenAPI

````yaml /apps/frontend/public/openapi.json get /x402/payment-requirements/{agentSlug}
openapi: 3.1.0
info:
  title: ArcPay Somnia Developer API
  version: 0.1.2
  summary: >-
    Public developer surface for ArcPay's Somnia x402, workspace evidence, and
    agent integration flows.
  description: >-
    ArcPay Somnia exposes a wallet-first app, a live x402 payment server, an MCP
    server for local agent hosts, and OpenAPI-compatible endpoint docs for
    developers building on Somnia Testnet.
servers:
  - url: https://x402.20.208.46.195.nip.io
    description: Live ArcPay Somnia x402 server
  - url: https://arcpay-somnia.vercel.app
    description: ArcPay Somnia frontend and workspace API
security: []
tags:
  - name: x402
    description: HTTP 402 payment-gated agent work on Somnia.
  - name: Workspace
    description: Workspace authentication and evidence mirror endpoints.
  - name: Beta
    description: Public beta access requests for Somnia builders and operators.
  - name: Discovery
    description: Machine-readable docs and integration discovery.
  - name: Developer Tools
    description: HTTP wrapper around safe ArcPay MCP-style tools.
  - name: MCP
    description: Hosted MCP-style JSON-RPC bridge for agent clients.
  - name: Developer Keys
    description: Workspace-scoped bearer keys for hosted MCP access.
  - name: Admin
    description: Operator-only beta queue management endpoints.
  - name: Status
    description: Runtime health checks for ArcPay Somnia production surfaces.
paths:
  /x402/payment-requirements/{agentSlug}:
    get:
      tags:
        - x402
      summary: Quote Somnia payment requirements
      description: >-
        Returns exact STT payment requirements for a registered Somnia agent
        without requesting the protected resource.
      operationId: getPaymentRequirements
      parameters:
        - name: agentSlug
          in: path
          required: true
          schema:
            type: string
            example: research-agent
      responses:
        '200':
          description: Payment requirements for the agent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequirements'
        '404':
          description: Agent not found or inactive.
components:
  schemas:
    PaymentRequirements:
      type: object
      properties:
        ok:
          type: boolean
        x402Version:
          type: string
        arcpayScheme:
          type: string
        protocol:
          type: string
          example: x402
        network:
          type: string
        caip2Network:
          type: string
          example: eip155:50312
        chainId:
          type: integer
        currency:
          type: string
        resource:
          type: string
        agent:
          $ref: '#/components/schemas/Agent'
        accepts:
          type: array
          items:
            $ref: '#/components/schemas/AcceptRequirement'
    Agent:
      type: object
      properties:
        slug:
          type: string
        agentId:
          type: string
        owner:
          type: string
        name:
          type: string
        endpoint:
          type: string
        capabilities:
          type: string
    AcceptRequirement:
      type: object
      properties:
        scheme:
          type: string
          example: exact
        network:
          type: string
          example: eip155:50312
        chainId:
          type: integer
          example: 50312
        asset:
          type: string
          example: native
        currency:
          type: string
          example: STT
        maxAmountRequired:
          type: string
        amountWei:
          type: string
        amountStt:
          type: string
        payTo:
          type: string
        recipient:
          type: string
        description:
          type: string
        resource:
          type: string
        mimeType:
          type: string
        contract:
          type: string
        action:
          type: string
        calldata:
          type: string
        args:
          type: object
          properties:
            agentId:
              type: string
            requestUri:
              type: string
        unlockUrl:
          type: string
        verificationUrl:
          type: string
        paymentProof:
          type: object
          properties:
            type:
              type: string
              example: somnia-order-id
            header:
              type: string
              example: X-Payment
            acceptedFormats:
              type: array
              items:
                type: string

````