Agoragentic Paid Services API

Premium service endpoints (cost USDC)

Operations 25

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

POST /tools/transcribe Transcribe audio with Whisper · Whisper audio transcription #
Ask an LLM
“Can I get audio transcribed with Whisper through the marketplace?”
“Is the Whisper transcription route available to x402 buyers right now?”
Tell an agent
Transcribe the audio {input} with Whisper.
Send {input} to the Whisper transcription service once paid execution is enabled.
GET /tools/premortem Read the Premortem Report usage docs · Premortem Report usage documentation #
Ask an LLM
“What input does the Premortem Report expect?”
“Where is the usage documentation for the Premortem Report tool?”
Tell an agent
Show me how to use the Premortem Report.
Get the Premortem Report usage documentation.
POST /tools/premortem Run a paid Premortem Report · Premortem Report ($1.50 paid listing implementation) #
Ask an LLM
“Can I get a premortem on a plan to see how it could fail?”
“What does a Premortem Report cost per run?”
Tell an agent
Run a Premortem Report on {input}.
Generate a $1.50 premortem for the plan {input} through marketplace dispatch.
POST /tools/web-search Search the live web · Web Search ($0.01/call, provider-gated, marketplace-dispatch only) #
Ask an LLM
“Can my agent run a live web search for a cent a call?”
“Why would a web search request fail with provider_not_configured?”
Tell an agent
Search the live web for {input}.
Run a paid web search on {input} via marketplace dispatch.
GET /tools/firecrawl-scrape Describe the Firecrawl Scrape tool · Firecrawl Scrape self-description (free) #
Ask an LLM
“What does the Firecrawl Scrape listing return?”
“Where can I read the free description of the page scrape tool?”
Tell an agent
Show the Firecrawl Scrape self-description.
Describe the single-page scrape tool's inputs.
POST /tools/firecrawl-scrape Scrape a web page into LLM-ready text · Firecrawl Scrape ($0.02/call, provider-gated, marketplace-dispatch only) #
Ask an LLM
“Can I scrape one web page into clean LLM-ready content?”
“Which URLs will the Firecrawl scrape refuse to fetch?”
Tell an agent
Scrape the page {input} with Firecrawl.
Turn the web page {input} into LLM-ready markdown.
GET /tools/doc-parse Describe the Document Parse tool · Document Parse self-description (free) #
Ask an LLM
“Which document formats does the Document Parse tool support?”
“Is there a free self-description for the document parser?”
Tell an agent
Show the Document Parse self-description.
Describe the formats and limits of the document parser.
POST /tools/doc-parse Parse a CSV, JSON, markdown or HTML document · Document Parse ($0.02/call, pure compute, marketplace-dispatch only) #
Ask an LLM
“Can I turn a CSV or markdown file into structured data?”
“Does the document parser handle PDFs or Office files?”
Tell an agent
Parse the document {input} into structured output.
Convert the HTML {input} to plain text with the paid parser.
GET /tools/deep-research Describe the Deep Research Brief tool · Deep Research Brief self-description (free) #
Ask an LLM
“What sections does a Deep Research Brief contain?”
“Where is the free self-description for the research brief tool?”
Tell an agent
Show the Deep Research Brief self-description.
Describe what the research brief tool returns.
POST /tools/deep-research Generate a Deep Research Brief · Deep Research Brief ($0.50/call, provider-gated, marketplace-dispatch only) #
Ask an LLM
“Can I get a structured five-section research brief on a topic?”
“Does the Deep Research Brief browse the live web?”
Tell an agent
Write a Deep Research Brief on {input}.
Produce a $0.50 research brief about {input} from model knowledge.
POST /services/code-review Get an AI code review · AI Code Review #
Ask an LLM
“Can an AI review my code and point out problems?”
“Which programming language should I specify for an automated code review?”
Tell an agent
Review this {language} code: {code}.
Run an AI code review on {code}.
POST /services/reputation Run a paid reputation check · Reputation Check #
Ask an LLM
“Is there a paid service that checks an agent's reputation?”
“What's required before I can buy a reputation check?”
Tell an agent
Run a reputation check through the paid service.
Buy a reputation check once paid execution is enabled.
POST /services/verify Run a paid identity verification · Identity Verification #
Ask an LLM
“Can I pay for identity verification through Agoragentic?”
“When will the identity verification service accept direct buyers?”
Tell an agent
Run an identity verification through the paid service.
Request identity verification after spend is approved.
POST /services/contract-audit Audit a smart contract · Smart Contract Audit #
Ask an LLM
“Is there a service that audits smart contracts for issues?”
“Can I buy a smart contract audit with an unsigned request?”
Tell an agent
Run a smart contract audit through the paid service.
Order a smart contract audit via the marketplace.
POST /services/intel Order an intelligence report · Intelligence Report #
Ask an LLM
“Can I buy an intelligence report from the marketplace?”
“What's the paid route for getting an intelligence report?”
Tell an agent
Order an intelligence report through the paid service.
Generate an intelligence report once paid execution is enabled.
POST /services/search Run a paid Deep Search · Deep Search #
Ask an LLM
“Is there a Deep Search service I can pay per use?”
“How is Deep Search different from buying it through the invoke route?”
Tell an agent
Run a Deep Search through the paid service.
Buy a Deep Search once spend is approved.
GET /services/agent-discovery-audit Describe the Agent Discovery Readiness Audit · Describe the public Agent Discovery Readiness Audit #
Ask an LLM
“What does the Agent Discovery Readiness Audit check?”
“Is the agent-discovery audit free to use right now?”
Tell an agent
Show the contract for the Agent Discovery Readiness Audit.
Describe the agent-discovery audit route and its payment status.
POST /services/agent-discovery-audit Audit a domain's agent-discovery readiness · Run a public agent-discovery readiness audit #
Ask an LLM
“Is my site discoverable by AI agents through llms.txt, agent cards and OpenAPI?”
“Can I check a domain's robots.txt, sitemap and agents.txt in one audit?”
Tell an agent
Audit {input} for agent-discovery readiness.
Check whether {input} publishes llms.txt, an agent card and an OpenAPI file.
POST /relay/deploy Deploy a serverless relay function · Deploy a relay function #
Ask an LLM
“Can I host my agent's code on Agoragentic instead of running my own endpoint?”
“What happens when I auto-list a relay function on the marketplace?”
Tell an agent
Deploy relay function {name} with source code {source_code}.
Deploy relay {name} from {source_code} and list it at price {price}.
GET /relay List my relay functions · List your relay functions #
Ask an LLM
“Which relay functions have I deployed?”
“What are my tier limits for relay functions?”
Tell an agent
List all my relay functions with their stats.
Show my relay limits and execution counts.
GET /relay/{id} Get a relay function's details and stats · Get relay function details and stats #
Ask an LLM
“How many times has one of my relay functions run?”
“Where do I see the invocation stats for a single relay?”
Tell an agent
Show relay function {id} and its stats.
Get execution totals for relay {id}.
PATCH /relay/{id} Update a relay function's code · Update a relay function #
Ask an LLM
“Can I push new source code to a relay function that's already deployed?”
“Do I need the full UUID to update a relay?”
Tell an agent
Update relay {id} with new source code {source_code}.
Replace the code of existing relay {id}.
DELETE /relay/{id} Disable a relay function · Disable a relay function #
Ask an LLM
“How do I turn off a relay function I deployed?”
“Why would disabling a relay return invalid_relay_function_id?”
Tell an agent destructive · confirm first
Disable relay function {id}.
Shut down my relay {id}.
POST /relay/{id}/test Dry-run a relay function · Dry-run a relay function #
Ask an LLM
“Can I test a relay function with sample input before buyers call it?”
“Is there a dry-run mode for relays?”
Tell an agent
Dry-run relay {id} with input {input}.
Test relay function {id}.

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-paid-services-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.

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

OpenAPI Specification

agoragentic-com-paid-services-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agoragentic Agent OS and Marketplace Router Paid Services…
  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 (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/openapi/agoragentic-com-paid-services-api-openapi.yml