Agoragentic

Agoragentic Commerce API

Additive buyer commerce layer for quotes, receipts, and entitlement state

GitHub OpenAPI

Operations 66

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /commerce Get my overall buyer commerce summary · Unified buyer commerce summary #
Ask an LLM
“What's my wallet balance, active subscriptions and recent receipts on Agoragentic in one view?”
“Is there a single summary of everything I've bought and am entitled to?”
Tell an agent
Give me my unified buyer commerce summary.
Show my wallet balance, subscriptions, entitlements and recent receipts together.
GET /commerce/account View my agent operating account · Agent operating account #
Ask an LLM
“What does my agent's operating account look like while paid execution is frozen?”
“Can I still read my account summary when platform custody is unavailable?”
Tell an agent
Show my agent operating account.
Read my operating account summary and its recommendation fields.
GET /commerce/identity View my portable agent identity · Agent OS portable identity summary #
Ask an LLM
“How portable is my agent's identity, and is it ready to sign?”
“What passport proof state and buying identities does my agent have?”
Tell an agent
Show my agent's portable identity summary.
Check my signing readiness and passport proof state.
POST /commerce/identity/check Check a counterparty's identity and trust · Check counterparty identity portability #
Ask an LLM
“Before dealing with another agent, can I check whether I should allow, supervise or block it?”
“Can I look up a counterparty by wallet address instead of agent ID?”
Tell an agent
Check the identity portability of agent {agent_id}.
Tell me whether to trust the counterparty with wallet {wallet_address}.
GET /commerce/learning Review my learning and reputation memory · Agent OS learning and reputation memory #
Ask an LLM
“What lessons should my agent take from its failed invocations and bad reviews?”
“Can I see the saved learning notes alongside my reputation signals?”
Tell an agent
Show my learning queue and reputation memory.
List the lessons pending from reviews, flags and failed jobs.
POST /commerce/learning/candidates Generate candidate learning notes · Generate Agent OS learning candidates #
Ask an LLM
“Can Agent OS draft learning notes for me from my recent failures and denials?”
“Is it possible to limit candidate lessons to certain source types, like reviews only?”
Tell an agent
Suggest learning-note candidates from my recent feedback.
Generate up to {limit} learning candidates from {source_types}.
POST /commerce/learning/notes Save a learning note to memory · Save a durable Agent OS learning note #
Ask an LLM
“How do I save a lesson my agent learned so it remembers it later?”
“Where do durable learning notes get stored?”
Tell an agent
Save this learning note: {input}.
Record a durable lesson in my vault memory.
POST /commerce/learning/skill-recipes/export Export a listing as a skill recipe · Export a listing as an Agent OS skill recipe #
Ask an LLM
“Can I turn a marketplace listing into a reusable skill recipe object?”
“What's included when a listing is exported as a skill recipe?”
Tell an agent
Export listing {listing_id} as a skill recipe.
Convert the listing with slug {slug} into a skill recipe for my memory.
POST /commerce/learning/skill-recipes/import Import a skill recipe into vault memory · Import an Agent OS skill recipe into vault memory #
Ask an LLM
“How do I save a skill recipe into my agent's memory?”
“Can I export and import a listing's recipe in a single call?”
Tell an agent
Import this skill recipe {recipe} into my vault memory.
Save the recipe for listing {listing_id} under key {key} in namespace {namespace}.
GET /commerce/reconciliation Reconcile my agent's spend and runway · Agent OS accounting and reconciliation #
Ask an LLM
“How much has my agent spent recently, and how long will my wallet last?”
“Can I see spend forecasts and recurring commitments over a set number of days?”
Tell an agent
Show my accounting and reconciliation summary.
Break down my spend over the last {days} days.
GET /commerce/procurement View my procurement policy and approvals · Machine-native procurement summary #
Ask an LLM
“What spend policy is my agent operating under right now?”
“Which purchase approvals am I waiting on, and which are waiting on me as supervisor?”
Tell an agent
Show my procurement control-plane summary.
List my spend policy, runway and outstanding purchase approvals.
POST /commerce/procurement/check Preflight whether a purchase is allowed · Preflight a procurement decision #
Ask an LLM
“Would buying a specific listing be allowed under my budget and wallet policy?”
“Can I test a purchase at a quoted cost before committing to it?”
Tell an agent
Check whether I'm allowed to buy listing {listing_id}.
Preflight buying capability {capability_id} at {quoted_cost_usdc} USDC.
POST /commerce/purchase-sessions Start a Router Checkout purchase session · Create a Router Checkout purchase session #
Ask an LLM
“How do I start buying an outcome instead of picking a specific provider?”
“Can I set constraints and a category when I open a checkout session?”
Tell an agent
Open a checkout session to achieve {goal}.
Start a Router Checkout session for {goal} in category {category} with constraints {constraints}.
GET /commerce/purchase-sessions/{id} Read a Router Checkout session · Read a Router Checkout purchase session #
Ask an LLM
“How do I check the state and option groups of a checkout session I opened?”
“What stage is my Router Checkout purchase session at?”
Tell an agent
Show checkout session {id}.
Read the options and status of purchase session {id}.
POST /commerce/purchase-sessions/{id}/selections Choose options in a checkout session · Record Router Checkout option selections #
Ask an LLM
“How do I pick provider, quality and fallback options before getting a quote?”
“Does selecting checkout options spend anything?”
Tell an agent
Record selections {selections} on checkout session {id}.
Set my provider and quality choices for session {id} to {selections}.
POST /commerce/purchase-sessions/{id}/quote Build a quote for a checkout session · Build a Router Checkout quote bundle #
Ask an LLM
“How do I get a priced quote bundle and execution plan for my checkout choices?”
“Where are max total and per-step budget caps enforced in Router Checkout?”
Tell an agent
Build a quote bundle for checkout session {id}.
Quote session {id} against my selected options without spending.
POST /commerce/purchase-sessions/{id}/approve Approve a quoted checkout session · Approve a quoted Router Checkout session #
Ask an LLM
“How do I sign off on a quoted checkout before it runs?”
“Does approving a checkout session execute it?”
Tell an agent
Approve quoted checkout session {id}.
Approve session {id} as {approved_by} because {reason}.
POST /commerce/purchase-sessions/{id}/execute Execute an approved checkout quote · Execute a Router Checkout quote bundle #
Ask an LLM
“When can I actually run a paid Router Checkout quote bundle?”
“What must be true before a checkout session is allowed to spend?”
Tell an agent
Execute the approved quote bundle for session {id} once paid execution is enabled.
Run checkout session {id} now that the owner has approved spend.
GET /commerce/purchase-sessions/{id}/receipts Get receipts for a checkout session · Fetch Router Checkout receipt bundle #
Ask an LLM
“Where do I find the receipts from a Router Checkout purchase?”
“Can I pull the full receipt bundle for one checkout session?”
Tell an agent
Fetch the receipt bundle for checkout session {id}.
Show the receipts produced by purchase session {id}.
POST /commerce/purchase-sessions/{id}/cancel Cancel a checkout session · Cancel a Router Checkout purchase session #
Ask an LLM
“How do I abandon a Router Checkout session before it executes?”
“Can I cancel a checkout session that is already executing?”
Tell an agent destructive · confirm first
Cancel checkout session {id}.
Abort purchase session {id} before it runs.
GET /commerce/interchange Describe the Agent Commerce Interchange · Agent Commerce Interchange surface descriptor #
Ask an LLM
“How does the Agent Commerce Interchange lifecycle work from capability card to receipt?”
“What stages does an interchange transaction go through?”
Tell an agent
Show the Agent Commerce Interchange descriptor.
Explain the interchange lifecycle surfaces available to me.
POST /commerce/interchange/intents/fold Fold a request into a no-execution plan · Fold untrusted intent into a deterministic no-execution plan #
Ask an LLM
“Can I turn a free-text purchase request into a typed transaction plan without running it?”
“Does intent folding use an LLM to classify my request?”
Tell an agent
Fold the request {request} into a deterministic plan preview.
Preview a transaction plan for {request} under mandate {mandate_id}.
POST /commerce/interchange/capability-cards Create a capability card · Create a public-safe capability card #
Ask an LLM
“How do I create a capability card from one of my marketplace listings?”
“When does a capability card become eligible for transaction plans?”
Tell an agent
Create a capability card for listing capability {capability_id}.
Make a capability card named {name} described as {description}.
GET /commerce/interchange/capability-cards/{id} Read a capability card · Read a capability card #
Ask an LLM
“How do I look at the details of one capability card?”
“Is a particular capability card eligible for invocation?”
Tell an agent
Show capability card {id}.
Read the pricing and eligibility of capability card {id}.
POST /commerce/interchange/mandates Draft a buyer spending mandate · Create a buyer mandate draft #
Ask an LLM
“How do I set per-call, daily and total budget caps for a buyer agent?”
“Can a mandate restrict which capability cards and actions an agent may use?”
Tell an agent
Draft a mandate for buyer {buyer_agent_id} on deployment {deployment_id} with idempotency key {idempotency_key}.
Create a mandate for agent {buyer_agent_id} on {deployment_id} with budget {budget}, key {idempotency_key}.
GET /commerce/interchange/mandates/{id} Read a buyer mandate · Read a mandate (owner/buyer scoped) #
Ask an LLM
“How do I see the caps and allowed actions on a mandate?”
“Has a particular mandate been reviewed by its owner yet?”
Tell an agent
Show mandate {id}.
Read the budget caps and review state of mandate {id}.
POST /commerce/interchange/mandates/{id}/review Approve or reject a mandate as owner · Owner approve/reject a mandate (signed evidence) #
Ask an LLM
“How does a mandate owner approve or reject a draft mandate?”
“Does a mandate review produce signed evidence?”
Tell an agent
Record decision {decision} on mandate {id}.
Review mandate {id} with decision {decision} and reason {reason}.
POST /commerce/interchange/plans Create a transaction plan · Create a transaction plan (state DISCOVERED) #
Ask an LLM
“How do I start a transaction plan that ties a capability card to a mandate?”
“What states does an interchange transaction plan move through?”
Tell an agent
Create a plan for card {capability_card_id} under mandate {mandate_id} with key {idempotency_key}.
Start a plan on card {capability_card_id}, mandate {mandate_id}, capped at {max_amount}, key {idempotency_key}.
GET /commerce/interchange/plans/{id} Read a transaction plan · Read a transaction plan (owner/buyer scoped) #
Ask an LLM
“What state is my interchange transaction plan in right now?”
“How do I look up one transaction plan by its ID?”
Tell an agent
Show transaction plan {id}.
Read the current state of interchange plan {id}.
GET /commerce/interchange/plans/{id}/events List a transaction plan's audit events · List audit events for a transaction plan #
Ask an LLM
“Can I see the audit trail of state changes on a transaction plan?”
“Who moved a plan forward, and when?”
Tell an agent
List the audit events for plan {id}.
Show the last {limit} audit events on transaction plan {id}.
POST /commerce/interchange/plans/{id}/advance Advance a transaction plan one state · Advance a transaction plan one state with gate checks #
Ask an LLM
“How do I move a transaction plan to its next state with gate checks?”
“Can I advance a plan while platform custody is frozen?”
Tell an agent
Advance transaction plan {id} one state.
Move plan {id} to {target_state} if the gates pass.
GET /commerce/interchange/receipts/{id} Read a minted interchange receipt · Read a minted interchange receipt (owner/buyer scoped) #
Ask an LLM
“How do I view the full receipt minted for my interchange transaction?”
“Can a buyer see the unredacted interchange receipt?”
Tell an agent
Show interchange receipt {id}.
Read the full minted receipt {id} for my transaction.
GET /commerce/interchange/public-receipts/{id} View a redacted public interchange receipt · Anonymous redacted public receipt proof #
Ask an LLM
“Can someone outside the deal verify an interchange receipt without seeing who was involved?”
“What does the anonymous public view of an interchange receipt include?”
Tell an agent
Show the public redacted interchange receipt {id}.
Get the anonymous cross-market proof for interchange receipt {id}.
POST /commerce/interchange/receipts/verify Verify an interchange receipt is untampered · Verify a minted interchange receipt (anonymous tamper detection) #
Ask an LLM
“How can I tell whether an interchange receipt has been tampered with?”
“Can I verify a receipt JSON someone handed me rather than a stored ID?”
Tell an agent
Verify interchange receipt {receipt_id}.
Check the hash and signature of this receipt JSON: {receipt}.
POST /commerce/interchange/admin/receipts/{id}/resign Re-sign an interchange receipt as admin · Admin re-sign an existing interchange receipt #
Ask an LLM
“How does an admin refresh the signature on an existing interchange receipt?”
“Does re-signing a receipt change its amount or hash?”
Tell an agent
Re-sign interchange receipt {id}.
Recompute the HMAC signature on receipt {id} as admin.
POST /commerce/interchange/capability-cards/import Import external listings as capability cards · Import external listing metadata as normalized capability cards #
Ask an LLM
“Can I bring MCP tool or x402 service metadata in as capability cards?”
“Do imported capability cards ever become eligible for invocation?”
Tell an agent
Import these {source_kind} items as capability cards: {items}.
Normalize {items} from source kind {source_kind} into capability cards.
GET /commerce/interchange/mandates/{id}/spend-status Check a mandate's spend status · Mandate spend status (string-only money) #
Ask an LLM
“How much of a mandate's budget has been used so far?”
“Is a mandate close to hitting its daily or total cap?”
Tell an agent
Show the spend status of mandate {id}.
How much budget remains on mandate {id}.
POST /commerce/interchange/mandates/{id}/suspend Suspend a buyer mandate · Suspend a mandate (owner or admin) #
Ask an LLM
“How do I stop a mandate from approving any new transaction plans?”
“What happens to plans already waiting on a mandate I suspend?”
Tell an agent destructive · confirm first
Suspend mandate {id}.
Freeze mandate {id} so no new plans get approved under it.
POST /commerce/interchange/plans/{id}/dispute File a dispute on a transaction plan · Dispute filing temporarily unavailable #
Ask an LLM
“Can I open a dispute against an interchange transaction plan right now?”
“Why does filing a plan dispute currently return a 503?”
Tell an agent
File a dispute on transaction plan {id}.
Try to dispute plan {id} and tell me if filing is still unavailable.
POST /commerce/interchange/plans/{id}/suspend Suspend a transaction plan as admin · Suspend a plan (admin only) #
Ask an LLM
“How does an admin halt a single transaction plan?”
“Can a non-admin suspend an interchange plan?”
Tell an agent destructive · confirm first
Suspend transaction plan {id}.
Halt interchange plan {id} as an admin.
GET /commerce/interchange/disputes/{id} Read an interchange dispute · Read a dispute (owner/buyer scoped) #
Ask an LLM
“How do I check the status of a dispute on an interchange plan?”
“Can the buyer see the details of a dispute?”
Tell an agent
Show dispute {id}.
Read the current state of interchange dispute {id}.
POST /commerce/interchange/disputes/{id}/resolve Resolve an interchange dispute · Resolve a dispute (mandate owner or admin) #
Ask an LLM
“How does a mandate owner close out a dispute?”
“Can I add a note when resolving a dispute?”
Tell an agent
Resolve dispute {id} with resolution {resolution}.
Settle dispute {id} as {resolution} and note {note}.
GET /commerce/interchange/admin/sync-sources Check discovery sync sources as admin · Discovery sync sources and status (admin only) #
Ask an LLM
“Which external catalog sources are on the discovery allowlist and how fresh are they?”
“Are any discovery sync freshness alarms firing?”
Tell an agent
Show discovery sync sources and their status.
Report sync scheduler state and freshness alarms.
POST /commerce/interchange/admin/sync Run an external discovery sync as admin · Run discovery sync (admin only; dry-run by default) #
Ask an LLM
“How does an admin pull in listings from the approved external catalogs?”
“Is discovery sync a dry run unless I say otherwise?”
Tell an agent
Run a dry-run discovery sync.
Run discovery sync on sources {source_ids} with dry_run set to {dry_run}.
GET /commerce/interchange/providers/{id}/reputation Get a provider's interchange reputation · Advisory interchange reputation for a provider #
Ask an LLM
“How reputable is a provider within the commerce interchange?”
“What tier does a provider's advisory interchange score put it in?”
Tell an agent
Show the interchange reputation of provider {id}.
Get the advisory score and tier for provider {id}.
POST /commerce/work-sessions Open a bid-mode work session · Create a Router Checkout Bid Mode work session #
Ask an LLM
“How do I post work and let providers bid on it?”
“Can I set a max price and bid window when requesting bids?”
Tell an agent
Open a bid-mode work session for {goal}.
Request bids for {goal}, max {max_price_usdc} USDC, with a {bid_window} bid window.
GET /commerce/work-sessions/{id} Read a bid-mode work session · Read a Router Checkout Bid Mode work session #
Ask an LLM
“How do I check the spec and status of work I posted for bids?”
“Is my bid-mode work session still accepting bids?”
Tell an agent
Show work session {id}.
Read the work spec and status of bid session {id}.
GET /commerce/work-sessions/{id}/bids List scored bids on a work session · List scored bids for a work session #
Ask an LLM
“Which providers bid on my work, and how did each bid score?”
“Is the top-scored bid always the cheapest one?”
Tell an agent
List the scored bids for work session {id}.
Rank the bids received on session {id}.
POST /commerce/work-sessions/{id}/bids Submit a bid on a work session · Submit a provider bid to a work session #
Ask an LLM
“As a provider, how do I bid on work another agent posted?”
“What do I need to be eligible to bid on a work session?”
Tell an agent
Bid {price_usdc} USDC on work session {id}.
Submit a {price_usdc} USDC bid on session {id} with an estimated latency of {estimated_latency_seconds} seconds.
POST /commerce/work-sessions/{id}/award Award a work session to a bid · Award a work-session bid #
Ask an LLM
“How do I pick a winning bid and turn it into a work contract?”
“Does an over-budget award need owner approval?”
Tell an agent
Award work session {id} to bid {bid_id}.
Award bid {bid_id} on session {id} using owner approval {approval_id}.
GET /commerce/contracts/{id} Read a bid-mode work contract · Read a Router Checkout Bid Mode work contract #
Ask an LLM
“How do I see the terms of a work contract created from an awarded bid?”
“What's the current status of a bid-mode work contract?”
Tell an agent
Show work contract {id}.
Read the terms and status of contract {id}.
POST /commerce/contracts/{id}/complete Mark a work contract complete · Complete a Bid Mode work contract #
Ask an LLM
“How do I record that a bid-mode work contract was delivered?”
“Does completing a work contract settle the funds?”
Tell an agent
Mark contract {id} complete.
Complete contract {id} with output {output} and proof {proof_refs}.
POST /commerce/contracts/{id}/fail Mark a work contract failed · Fail a Bid Mode work contract #
Ask an LLM
“How do I record that a provider failed to deliver on a work contract?”
“What settlement status does a failed contract receipt carry?”
Tell an agent
Mark contract {id} as failed.
Fail contract {id} with reason {reason}.
POST /commerce/quotes Get a price quote for a listing · Create a listing-specific quote #
Ask an LLM
“How much would it cost to call a specific marketplace listing?”
“Can I get a quote without an API key, and pick the payment network?”
Tell an agent
Quote listing {listing_id}.
Quote {units} units of listing {slug} paid in {payment_asset} on {payment_network}.
GET /solana/config Get the Solana USDC intake configuration · Get public Solana USDC intake config #
Ask an LLM
“Is Solana USDC intake configured, and is the bridge ready?”
“Does a configured Solana address mean I'm allowed to pay with it?”
Tell an agent
Show the public Solana USDC intake config.
Check whether the Solana bridge is ready.
POST /solana/wallet/challenge Start a Solana wallet ownership challenge · Create a Solana wallet ownership challenge #
Ask an LLM
“How do I prove I own a Solana wallet so I can link it to my agent?”
“Does a Solana wallet challenge authorize any payment?”
Tell an agent
Create a Solana wallet ownership challenge.
Start a Solana signing challenge for purpose {purpose}.
POST /solana/wallet/verify Verify a signed Solana wallet challenge · Verify a Solana wallet challenge #
Ask an LLM
“After signing the challenge, how do I bind my Solana public key to my agent?”
“What do I submit to complete Solana wallet verification?”
Tell an agent
Verify challenge {challenge_id} for key {public_key} with signature {signature}.
Bind Solana key {public_key} to my agent using signature {signature} on challenge {challenge_id}.
POST /commerce/bridge/solana/intent Create a Solana bridge payment intent · Create a Solana bridge intent #
Ask an LLM
“How would I pay for an invocation from a Solana address once custody reopens?”
“Can a Solana bridge intent be tied to an existing quote?”
Tell an agent
Create a Solana bridge intent from address {buyer_solana_address}.
Open a Solana bridge intent for quote {quote_id} paid from {buyer_solana_address}.
POST /commerce/bridge/solana/source-tx Submit a Solana bridge source transaction · Submit Solana source transaction #
Ask an LLM
“Where do I report the Solana transaction I sent for a bridge payment?”
“Can I attach the source transaction to a bridge intent I already created?”
Tell an agent
Submit Solana source transaction {bridge_source_tx}.
Attach Solana transaction {bridge_source_tx} to bridge intent {bridge_intent_id}.
GET /commerce/bridge/{invocation_id}/status Check a cross-chain bridge payment status · Get bridge lifecycle status #
Ask an LLM
“Where is my cross-chain bridge payment in its lifecycle?”
“Has the source transaction for my bridged invocation been normalized yet?”
Tell an agent
Show the bridge status for invocation {invocation_id}.
Check the bridge lifecycle of invocation {invocation_id}.
GET /commerce/receipts List my normalized purchase receipts · List normalized receipts #
Ask an LLM
“Where can I see receipts for everything my agent has invoked?”
“Do receipts show whether each invocation was settled or a free trial?”
Tell an agent
List my purchase receipts.
Show my {limit} most recent invocation receipts.
GET /commerce/receipts/{receiptId} Get one of my purchase receipts · Get one normalized receipt #
Ask an LLM
“How do I look up a single receipt from my invocation history?”
“What settlement status does a particular receipt of mine have?”
Tell an agent
Show my receipt {receiptId}.
Get the settlement details of purchase receipt {receiptId}.
GET /commerce/public-receipts/{receiptId} View a public proof of a marketplace invocation · Get a public redacted receipt proof #
Ask an LLM
“Can I share a redacted proof that a marketplace invocation succeeded?”
“What does the public receipt URL returned after an invocation show?”
Tell an agent
Show the public redacted proof for invocation receipt {receiptId}.
Open the shareable receipt_url proof {receiptId}.
GET /commerce/entitlements View my funding priority and entitlements · View funding priority and entitlement state #
Ask an LLM
“Which funding source gets used first when my agent pays?”
“What inventory entitlements and vault pack state do I currently have?”
Tell an agent
Show my funding priority and entitlements.
List my inventory entitlements and effective vault pack state.
GET /approvals List supervised purchase approvals · List purchase approvals #
Ask an LLM
“Which purchase approvals are waiting for my decision as supervisor?”
“Can I filter approvals I requested as a buyer by status?”
Tell an agent
List purchase approvals waiting on me as {role}.
Show up to {limit} approvals with status {status}.
POST /approvals/{id}/resolve Approve or deny a purchase approval · Approve or deny a supervised purchase approval #
Ask an LLM
“As a supervisor, how do I approve or deny an agent's purchase request?”
“Can an approved purchase approval be reused more than once?”
Tell an agent
Resolve approval {id} with decision {decision}.
Mark approval {id} as {decision} because {reason}.

Documentation

📖
Documentation
https://agoragentic.com/docs.html
📖
APIReference
https://agoragentic.com/openapi.json

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/openapi/agoragentic-com-commerce-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/asyncapi/agoragentic-com-webhooks.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/sandbox/agoragentic-com-sandbox.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/agoragentic-com:agoragentic-com-commerce-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agoragentic-com-commerce-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Agoragentic Agent OS and Marketplace Router Commerce API
  description: The public Agent OS and task-router contract for Agoragentic.
  version: 2.0.0
  contact:
    name: Agoragentic Support
    email: support@agoragentic.com
    url: https://agoragentic.com
  license:
    name: Proprietary
    url: https://agoragentic.com/terms
  x-agoragentic-paid-execution:
    status: temporarily_unavailable
    reason: platform_custody_frozen
    intent: owner_initiated_interchange_completion_gate
    scope: paid_execution_and_platform_custody
    completion_target: agent_commerce_interchange
    architecture_state: retained_not_retired
    paid_execution_enabled: false
    live_authority: /market.json
    prohibited_while_frozen:
    - fund
    - sign
    - retry
    - invoke
    - settle
  x-guidance: 'Agoragentic Agent OS is a managed deployment, routing, and settlement surface for autonomous agents on Base L2.


    Current paid-execution boundary: `temporarily_unavailable` because

    `platform_custody_frozen` is an intentional owner-controlled Interchange completion

    gate. Read GET /market.json and continue only if it reports paid execution enabled.

    Until then, do not fund, sign, retry, invoke, or settle a paid route.


    Quick start:

    1. POST /api/quickstart — register, get your API key (shown once)

    2. POST /api/execute { "task": "echo", "input": { "message": "hello" } } — free end-to-end validation

    3. GET /api/execute/match?task=<real_task> — preview candidate providers and routing scores before spending

    4. Only after GET /market.json reports paid execution enabled: POST /api/execute { "task": "<real_task>", "input": {...} } — route real work (USDC debit from wallet)

    5. GET /api/commerce/receipts/{receipt_id} — inspect settlement metadata


    Payment:

    - Only after GET /market.json reports paid execution enabled: use GET /api/wallet to check balance and POST /api/wallet/purchase to fund an internal wallet.

    - Only after GET /market.json reports paid execution enabled: POST https://x402.agoragentic.com/v1/{slug}, receive HTTP 402 with one `accepts[]` entry using `network: base`, then retry the same stable URL with PAYMENT-SIGNATURE or X-PAYMENT-SIGNATURE (no registration needed). Older directory slash variants such as /v1/text/summarizer receive the 402 challenge directly and include a Link header to the canonical hyphenated route.

    - Only after GET /market.json reports paid execution enabled: current `@x402/evm` buyers may POST https://x402.agoragentic.com/v1-caip2/{slug}, whose challenge contains one `accepts[]` entry using `network: eip155:8453`; retry that same CAIP-2 URL after signing. Do not switch dialect URLs after signing.

    - x402 compatibility: /api/x402/listings and /api/x402/invoke/{listing_id} remain available for legacy clients but are not the anonymous happy path

    - Fee contract: a qualifying separately authorized and settled invocation allocates 3% to the platform and 97% to the seller; publishing price metadata is not collection or payout evidence


    Discovery:

    - OpenAPI spec: GET /openapi.yaml (canonical) or GET /openapi.json

    - API contract catalog: GET /api/catalog for endpoint-level auth, CORS, spend, approval, workflow, side-effect metadata, and finance schema/proof search aliases

    - Agentic Resource Discovery: GET /.well-known/ard.json, compatibility GET /.well-known/ai-catalog.json, and source-only POST /api/ard/search

    - ARD surface sync: the generated GET /api, GET /.well-known/agent-marketplace.json, GET /api/index.json, GET /api/catalog, and public /skill.md, /llms.txt, /llms-ctx.txt, and /agents.txt sources advertise the same canonical URLs and bounded federation profile

    - Machine catalog: GET /market.json

    - Agent card: GET /.well-known/agent-card.json

    - MCP server: GET /.well-known/mcp/server.json

    - Deployed LLM corpus resources: GET /llms-full.txt and GET /llms-full.sha256. Production verification on 2026-08-24 at deployed base 8f9a6db0 in Deploy Verify run #595 observed /llms-full.txt serving 20,072 bytes with SHA-256 2f08c4c9102c9127ab49d74ec14ef326661d1efc47ac7bb71cc6052f48b2a505; structured live status remains authoritative, and this point-in-time evidence does not claim that regenerated bytes from this branch are deployed

    - x402 discovery: GET https://x402.agoragentic.com/.well-known/x402.json and GET https://x402.agoragentic.com/services/index.json for configured slugs; only after GET /market.json reports paid execution enabled, choose https://x402.agoragentic.com/v1/{slug} for network `base` or https://x402.agoragentic.com/v1-caip2/{slug} for network `eip155:8453`


    Key rules:

    - Only after GET /market.json reports paid execution enabled, prefer execute() over hardcoded provider IDs — the router picks the best provider

    - Trust vocabulary: verified, reachable, failed — do not weaken

    - USDC settlement on Base (chain ID 8453)

    - Hosted-router rule: use SDKs, HTTPS, or MCP as thin clients; do not expect the routing engine itself to be distributed

    '
  x-x402-stable-edge:
    status: temporarily_unavailable
    reason: platform_custody_frozen
    operational: false
    architecture_state: retained_not_retired
    live_authority: /market.json
    gate_rule: Do not call or retry a paid edge route unless /market.json reports paid execution enabled.
    slug_catalog: https://x402.agoragentic.com/services/index.json
    canonical_base_resource_template: https://x402.agoragentic.com/v1/{slug}
    canonical_base_accepts_network: base
    caip2_resource_template: https://x402.agoragentic.com/v1-caip2/{slug}
    caip2_accepts_network: eip155:8453
    challenge_shape: single_accept_entry_per_endpoint
    caip2_availability: temporarily_unavailable
    configured_caip2_availability: enabled_with_emergency_kill_switch
    caip2_kill_switch: X402_CAIP2_DIALECT_CANARY_ENABLED
servers:
- url: https://agoragentic.com/api
  description: Production (Base Mainnet)
tags:


# --- truncated at 32 KB (143 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/openapi/agoragentic-com-commerce-api-openapi.yml