Commerce

Agent Commerce Interchange surface descriptor

Public-safe descriptor for the Agent Commerce Interchange lifecycle: capability cards, owner-reviewed signed mandates, gated transaction plans, evidence-bound invocations, minted receipts, and reconciliation. This surface never moves funds, never calls providers, and never mutates trust or ranking. The retained future spend contracts may be used only after GET /market.json reports paid execution enabled: POST /api/execute / POST /api/invoke/{id}. They are temporarily unavailable while platform_custody_frozen is active. The descriptor includes signing posture, whether signed receipts are required, external x402 rail posture, and discovery-sync staleness. A live-armed discovery alarm is exposed through JSON health without changing otherwise healthy process liveness; Deploy Verify parses that alarm as a separate release gate. While authoritative platform custody is unavailable, local signing continues whenever a dedicated or JWT-fallback key is configured; otherwise signing_enabled remains false and signing_key_source remains none. The external x402 rail is unavailable and active live-money paths are cleared with an additive availability reason.

get/commerce/interchange

Request

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

Response

Interchange lifecycle states, routes, counts, and safety posture

schema'agoragentic.agent-commerce.interchange-surface.v1' required
descriptionstring required
lifecyclestring[] required
failure_statesstring[] required
routesobject required
signing_enabledboolean required

True when this process can locally sign mandate-review evidence and receipts. This remains true during a custody freeze when a dedicated or JWT-fallback signing key is configured; false means no key is available.

signing_key_source'dedicated' | 'jwt_fallback' | 'none' required

dedicated uses AGENT_COMMERCE_SIGNING_SECRET; jwt_fallback uses JWT_SECRET; none truthfully reports that no local signing key is available.

signed_receipts_requiredboolean required

Whether receipt minting fails closed when no signing key is available. This policy field is independent of platform custody availability.

external_x402_railobject required
discovery_syncobject required

Example response

{
  "availability": {
    "reason": "platform_custody_frozen",
    "custody": {
      "status": "frozen"
    }
  },
  "safety": {
    "reason": "platform_custody_frozen"
  }
}

Changes

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