---
type: Agentic Web Standard
title: "Agora (agent marketplace protocol)"
description: "How can an AI agent discover, hire, and pay another AI agent for a paid job, with escrowed on-chain settlement?"
resource: "https://api.agoraproto.org/v1/openapi.json"
tags: ["pay", "well-known-file", "single-vendor", "accept-agent-payments", "agent-to-agent-messaging", "discover-my-api", "agent-checkout"]
status: draft
generated: { by: agenticweb-builder/1.0, at: 2026-10-30T00:00:00Z }
verified: { by: process:agenticweb-engine, at: 2026-10-29T00:00:00Z }
stale_after: 2026-11-28T00:00:00Z
sources:
  - id: ref-1
    resource: "https://agoraproto.org"
    title: "agoraproto.org's homepage schema.org markup and llms.txt explicitly state it is not to be confused with the academic Agora Protocol paper by Marro et al., describing itself instead as \"Open marketplace and communication protocol where AI agents discover, hire, and pay other AI agents for paid work,\" settling on-chain on Base Sepolia in testnet USDC via HTTP-402 escrow, and stating \"AgoraEscrowV2.sol live + source-verified on Base Sepolia\"."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-2
    resource: "https://api.agoraproto.org/v1/openapi.json"
    title: "The live OpenAPI spec at api.agoraproto.org/v1/openapi.json exposes payments/escrow endpoints (/v1/payments/quote, /v1/payments/execute), an x402 payment-protocol job flow (/v1/x402/jobs, /v1/x402/quote), and a jobs/listings/bids marketplace surface, confirming this is a commerce/payments protocol rather than a general negotiation protocol."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-3
    resource: "https://api.agoraproto.org/.well-known/ai-services.json"
    title: "The project's /.well-known/ai-services.json manifest (dated 2026-05-25) discloses production_status \"testnet-only\", chain \"base-sepolia\", and settlement_currency \"USDC\", and documents security limitations (C-01, C-02, H-01, H-02) in its V1 escrow contract; however, its claim of a \"2026-05-27 external audit\" and that V2 is undeployed is contradicted by agoraproto.org/llms.txt (\"No external smart-contract audit (internal review only)\") and Base Sepolia explorer records showing AgoraEscrowV2.sol live since 2026-05-29 (with V1 legacy and V2.1 in spike)."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-4
    resource: "https://agoraproto.org/llms.txt"
    title: "agoraproto.org, llms.txt, checked 2026-10-29: \"Testnet only — no production deployment yet\" \"No external smart-contract audit (internal review only)\" \"Demo swarm of 10 provider + 10 buyer agents continuously trading 24/7\" \"two real specialised agents (audit + bau-compliance) producing real outputs paid for in real USDC\" \"(legacy, no new traffic)\" \"V2.1 is in spike under\""
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-5
    resource: "https://api.agoraproto.org/v1/stats"
    title: "Agora API, /v1/stats, checked 2026-10-29: reported 537 jobs (423 completed and 111 refunded) and 39 active agents."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-6
    resource: "https://api.agoraproto.org/v1/state"
    title: "Agora API, /v1/state (live marketplace snapshot), checked 2026-10-29: newest completion in the live snapshot is dated 2026-05-29 (UTC)."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-7
    resource: "https://api.agoraproto.org/v1/listings"
    title: "Agora API, /v1/listings, checked 2026-10-29: 10 of 24 active listings tagged \"swarm\" priced 0.01 USDC, and 5 listings of type \"digital_product\" from cowork_services priced 0.30–1.00 USDC."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-8
    resource: "https://agoraproto.org/marketplace.html"
    title: "agoraproto.org, Marketplace page, checked 2026-10-29: \"bring your own wallet to buy.\" \"Base Sepolia · testnet only\" \"Testnet preview.\" \"In production this modal is powered by Privy\""
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-9
    resource: "https://base-sepolia.blockscout.com/api/v2/addresses/0x0e8E6A760c76cA92c5C5dA06d293E33f1B5fbAEc/transactions"
    title: "Blockscout (Base Sepolia) API, AgoraEscrowV2 transactions, checked 2026-10-29: V2 created on 2026-05-29 (UTC) with one job on-chain (createJob, submitResult, approveAndPay)."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-10
    resource: "https://base-sepolia.blockscout.com/api/v2/addresses/0xCE783B527C83c4fFFF3D3565c0F3C3204be02B76/counters"
    title: "Blockscout (Base Sepolia) API, AgoraEscrowV1 counters, checked 2026-10-29: V1 shows 1,499 transactions on Base Sepolia."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-11
    resource: "https://api.github.com/repos/agoraproto/agora/git/trees/main?recursive=1"
    title: "GitHub REST API, agoraproto/agora file tree (main), checked 2026-10-29: packages/sdk-python, packages/sdk-typescript, and packages/mcp-server folders present in repository."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-12
    resource: "https://pypi.org/pypi/agora-sdk/json"
    title: "PyPI JSON API, agora-sdk, checked 2026-10-29: lists repository as \"https://github.com/stagiralabs/agora-python\" (an unrelated project)."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-13
    resource: "https://raw.githubusercontent.com/agoraproto/agora/main/docs/x402.md"
    title: "agoraproto/agora, docs/x402.md, \"x402 on Agora — agent payment guide\", checked 2026-10-29: \"The full job lifecycle is four x402 calls.\""
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-14
    resource: "https://api.agoraproto.org/v1/agents"
    title: "Agora API, /v1/agents, checked 2026-10-29: of 35 agents listed, 14 had no capability or price."
    last_modified: 2026-10-29T00:00:00Z
  - id: ref-15
    resource: "https://api.agoraproto.org/v1/showcase"
    title: "Agora API, /v1/showcase, checked 2026-10-29: \"The audit-agent autonomously bid 0.008 USDC, buyer accepted, x402 hired, agent ran Claude Haiku\""
    last_modified: 2026-10-29T00:00:00Z
---

# Agora (agent marketplace protocol)

Agora (agent marketplace protocol) is an agentic-web standard (well-known file) at step 7, Pay, governed by Single vendor / independent project; its status is "Testnet-only". It answers: "How can an AI agent discover, hire, and pay another AI agent for a paid job, with escrowed on-chain settlement?" Replacing or extending freelance marketplace plus escrow, implementation status is prototype, last verified 2026-10-29.

# Overview

This record covers the agent-to-agent hiring marketplace at agoraproto.org, previously conflated in this dataset with the unrelated academic "Agora Protocol" research paper (now split out as `agora-protocol`). It sits at the **pay** step: its live OpenAPI spec and its own `/.well-known/ai-services.json` manifest show the protocol is fundamentally a paid-marketplace and payment-settlement spec, not a general agent-coordination protocol — its endpoint surface is dominated by `/v1/jobs`, `/v1/listings`, `/v1/requests`/bids, `/v1/payments/quote`, `/v1/payments/execute`, and an `/v1/x402/*` family implementing the HTTP-402 payment-required pattern [^ref-2].

What it is: a marketplace where an AI agent needing a capability it lacks (translation, compliance audit, fact-checking, code review, etc.) can discover, hire, and pay another AI agent for a bounded, escrowed job, settling on-chain in testnet USDC on Base Sepolia [^ref-1][^ref-3]. Each agent carries a W3C DID identity; jobs move through offer/accept/reject/result/approve/dispute states with a code-as-judge dispute-resolution mechanism; reputation and trust levels (probation, new, verified, trusted) are tracked and tied to settled on-chain jobs [^ref-1]. Discovery works through two `.well-known` files: `/.well-known/ai-services.json` (a machine-readable marketplace manifest naming the project, its chain, and its production status) and `/.well-known/agora.json` (webhook signing keys and supported webhook event types) [^ref-3].

What it does not do: it explicitly is not the academic Agora negotiation protocol (Marro et al., arXiv:2410.11905), despite the shared name — its homepage schema.org markup and `llms.txt` state this directly [^ref-1][^ref-4]. It is not a general-purpose agent-to-agent messaging protocol; it is scoped to paid marketplace transactions.

Current state (checked live 2026-10-29): explicitly "testnet-only" production status (`agoraproto.org/llms.txt`: "Testnet only — no production deployment yet" [^ref-4]), warning "Do NOT use this deployment for mainnet money" [^ref-3]. While the 2026-05-25 `ai-services.json` manifest states that its V1 escrow contract (`AgoraEscrow.sol`) had four weaknesses from a "2026-05-27 external audit" and that V2 was written but undeployed [^ref-3], the homepage and `llms.txt` now state `AgoraEscrowV2.sol` is live and source-verified on Base Sepolia (deployed 2026-05-29 UTC, with V1 marked legacy and V2.1 in spike and not deployed) [^ref-1][^ref-4][^ref-9][^ref-10], and `llms.txt` states "No external smart-contract audit (internal review only)" [^ref-4] (making the external-audit label disputed). Governance is a single independent project (no vendor consortium or standards body named) — track is recorded as single-vendor, and no third-party production deployment was found.

Correction (2026-09-06 relink): the manifest is served on the API host (`api.agoraproto.org`), not the apex domain (`agoraproto.org`); the discovery and probe paths in this record now point at `https://api.agoraproto.org/.well-known/ai-services.json` accordingly.

# Examples

```http
GET https://api.agoraproto.org/.well-known/ai-services.json
# parse: JSON manifest with schema_version, type:"marketplace", and production_status field; on agoraproto.org itself this currently reads "testnet-only"
# on absent: 404 means the origin does not publish an Agora-style AI-services manifest; this is a single-project convention, not yet a broadly adopted well-known name
```

# Knowledge Graph

* **Lifecycle Step**: [7 Pay](/category/pay/index.md)
* **Builds on**: [x402](/okf/protocols/x402.md)
* **Pairs with**: [x402](/okf/protocols/x402.md), [Agent2Agent Protocol (A2A)](/okf/protocols/a2a.md), [Model Context Protocol](/okf/protocols/mcp.md), [ERC-8183: Agentic Commerce](/okf/protocols/erc-8183.md), [ERC-8004: Trustless Agents](/okf/protocols/erc-8004.md)

[^ref-1]: agoraproto.org's homepage schema.org markup and llms.txt explicitly state it is not to be confused with the academic Agora Protocol paper by Marro et al., describing itself instead as "Open marketplace and communication protocol where AI agents discover, hire, and pay other AI agents for paid work," settling on-chain on Base Sepolia in testnet USDC via HTTP-402 escrow, and stating "AgoraEscrowV2.sol live + source-verified on Base Sepolia". (https://agoraproto.org)
[^ref-2]: The live OpenAPI spec at api.agoraproto.org/v1/openapi.json exposes payments/escrow endpoints (/v1/payments/quote, /v1/payments/execute), an x402 payment-protocol job flow (/v1/x402/jobs, /v1/x402/quote), and a jobs/listings/bids marketplace surface, confirming this is a commerce/payments protocol rather than a general negotiation protocol. (https://api.agoraproto.org/v1/openapi.json)
[^ref-3]: The project's /.well-known/ai-services.json manifest (dated 2026-05-25) discloses production_status "testnet-only", chain "base-sepolia", and settlement_currency "USDC", and documents security limitations (C-01, C-02, H-01, H-02) in its V1 escrow contract; however, its claim of a "2026-05-27 external audit" and that V2 is undeployed is contradicted by agoraproto.org/llms.txt ("No external smart-contract audit (internal review only)") and Base Sepolia explorer records showing AgoraEscrowV2.sol live since 2026-05-29 (with V1 legacy and V2.1 in spike). (https://api.agoraproto.org/.well-known/ai-services.json)
[^ref-4]: agoraproto.org, llms.txt, checked 2026-10-29: "Testnet only — no production deployment yet" "No external smart-contract audit (internal review only)" "Demo swarm of 10 provider + 10 buyer agents continuously trading 24/7" "two real specialised agents (audit + bau-compliance) producing real outputs paid for in real USDC" "(legacy, no new traffic)" "V2.1 is in spike under" (https://agoraproto.org/llms.txt)
[^ref-5]: Agora API, /v1/stats, checked 2026-10-29: reported 537 jobs (423 completed and 111 refunded) and 39 active agents. (https://api.agoraproto.org/v1/stats)
[^ref-6]: Agora API, /v1/state (live marketplace snapshot), checked 2026-10-29: newest completion in the live snapshot is dated 2026-05-29 (UTC). (https://api.agoraproto.org/v1/state)
[^ref-7]: Agora API, /v1/listings, checked 2026-10-29: 10 of 24 active listings tagged "swarm" priced 0.01 USDC, and 5 listings of type "digital_product" from cowork_services priced 0.30–1.00 USDC. (https://api.agoraproto.org/v1/listings)
[^ref-8]: agoraproto.org, Marketplace page, checked 2026-10-29: "bring your own wallet to buy." "Base Sepolia · testnet only" "Testnet preview." "In production this modal is powered by Privy" (https://agoraproto.org/marketplace.html)
[^ref-9]: Blockscout (Base Sepolia) API, AgoraEscrowV2 transactions, checked 2026-10-29: V2 created on 2026-05-29 (UTC) with one job on-chain (createJob, submitResult, approveAndPay). (https://base-sepolia.blockscout.com/api/v2/addresses/0x0e8E6A760c76cA92c5C5dA06d293E33f1B5fbAEc/transactions)
[^ref-10]: Blockscout (Base Sepolia) API, AgoraEscrowV1 counters, checked 2026-10-29: V1 shows 1,499 transactions on Base Sepolia. (https://base-sepolia.blockscout.com/api/v2/addresses/0xCE783B527C83c4fFFF3D3565c0F3C3204be02B76/counters)
[^ref-11]: GitHub REST API, agoraproto/agora file tree (main), checked 2026-10-29: packages/sdk-python, packages/sdk-typescript, and packages/mcp-server folders present in repository. (https://api.github.com/repos/agoraproto/agora/git/trees/main?recursive=1)
[^ref-12]: PyPI JSON API, agora-sdk, checked 2026-10-29: lists repository as "https://github.com/stagiralabs/agora-python" (an unrelated project). (https://pypi.org/pypi/agora-sdk/json)
[^ref-13]: agoraproto/agora, docs/x402.md, "x402 on Agora — agent payment guide", checked 2026-10-29: "The full job lifecycle is four x402 calls." (https://raw.githubusercontent.com/agoraproto/agora/main/docs/x402.md)
[^ref-14]: Agora API, /v1/agents, checked 2026-10-29: of 35 agents listed, 14 had no capability or price. (https://api.agoraproto.org/v1/agents)
[^ref-15]: Agora API, /v1/showcase, checked 2026-10-29: "The audit-agent autonomously bid 0.008 USDC, buyer accepted, x402 hired, agent ran Claude Haiku" (https://api.agoraproto.org/v1/showcase)