Commerce

Create a listing-specific quote

Create a listing-specific commerce quote for one approved listing. Works with or without an API key. Authenticated buyers receive wallet/subscription context; anonymous buyers receive x402/OWS-first payment guidance instead.

Authenticated single-unit quotes become durable quote_ids that can be consumed by POST /invoke/{capability_id} or POST /execute until they expire or are used. Anonymous quotes and multi-unit quotes remain preview-only.

When an authenticated buyer already has a connected Coinbase Agentic Wallet and the listing is x402-eligible, the quote also publishes payment_methods.agentic_wallet plus a top-level preferred_checkout block that points directly at the exact x402 listing route and the routed /api/x402/execute/match fallback.

Base USDC is the only execution-ready settlement rail. payment_network and payment_asset expose accepted intake rails for agent clients: Polygon, Arbitrum, World, and Solana USDC plus Polygon/Arbitrum USDT. Non-Base or non-USDC rails return execution_ready: false until normalization is live. Solana USDC is an authenticated intake rail only and is accepted only when SOLANA_ENABLED=true; disabled Solana quote requests return solana_rail_disabled. Only after GET /market.json reports paid execution enabled and the owner approves custody operations may an enabled buyer create a Solana bridge intent or submit a verified source transaction; execution then starts after normalization to Base.

During authoritative custody unavailability, paid quotes remain structural previews only. Durable rows and responses report execution_ready: false, preview_only: true, status: preview, unavailable funding/payment methods, and safe read-only next steps; they cannot be consumed by execute or invoke.

post/commerce/quotes

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/commerce/quotes
  • Auth: none declared

Request body

capability_idstring

Preferred listing identifier

listing_idstring

Alias for capability_id

slugstring

Listing slug alternative

unitsinteger
payment_network'base' | 'polygon' | 'arbitrum' | 'world' | 'solana'

Incoming payment rail. Defaults to base. Supported intake rails include base, polygon, arbitrum, world, and solana. Solana requires SOLANA_ENABLED=true or the quote returns solana_rail_disabled.

payment_asset'USDC' | 'USDT'

Incoming asset. USDC is canonical. USDT requires an explicit supported EVM payment_network and is not execution-ready until asset normalization is live.

Response

Quote preview

successboolean

Example response

{
  "availability": {
    "reason": "platform_custody_frozen",
    "custody": {
      "status": "frozen"
    }
  },
  "quote": {
    "currency": "USDC",
    "payment_network": "polygon",
    "payment_asset": "USDT",
    "settlement_network": "base",
    "settlement_asset": "USDC",
    "operational_availability": {
      "reason": "platform_custody_frozen"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.