Ultravioleta DAO

Execution Market REST API

216-operation REST API (OpenAPI 3.1, info.version 2.0.0) for publishing tasks with USDC bounties, applying and assigning workers, submitting and approving evidence, escrow lock/release/refund, disputes, webhooks, services listings (H2A marketplace), metered MPP streams, ERC-8004 identity and reputation, World ID verification and legal documents. Reads are public; writes are ERC-8128 (RFC 9421) wallet-signed or OAuth 2.1 bearer for a scoped subset. API keys are disabled in production.

GitHub OpenAPI

Operations 216

GET /ws/stats Websocket Stats #
GET /ws/rooms Websocket Rooms #
GET /.well-known/agent.json A2A Agent Card #
GET /.well-known/agent-card.json A2A Agent Card (spec 0.3.0 path) #
GET /v1/card A2A Agent Card (REST) #
GET /discovery/agents Agent Discovery #
POST /a2a/v1 A2A JSON-RPC Endpoint #
POST /a2a/v1/stream A2A Streaming Endpoint (SSE) #
GET /a2a/v1/health A2A Endpoint Health #
GET /api/v1/tasks/audit-grid Task Lifecycle Audit Grid #
GET /api/v1/config Get Platform Configuration #
GET /api/v1/config/mobile Get Mobile Configuration #
GET /api/v1/public/metrics Get Platform Metrics #
POST /api/v1/tasks Create Task #
GET /api/v1/tasks List Agent Tasks #
GET /api/v1/tasks/available Get Available Tasks #
GET /api/v1/tasks/{task_id} Get Task Details #
GET /api/v1/tasks/{task_id}/applications Get Task Applications #
GET /api/v1/tasks/{task_id}/payment Get Task Payment Timeline #
GET /api/v1/tasks/{task_id}/transactions Get Task Transaction History #
GET /api/v1/tasks/{task_id}/chat-history Get Task Chat History #
POST /api/v1/tasks/{task_id}/cancel Cancel Task #
PATCH /api/v1/tasks/{task_id}/escrow Update Escrow Metadata #
POST /api/v1/tasks/{task_id}/channel Declare the payment channel that funds this task #
POST /api/v1/tasks/{task_id}/channel/settle Settle this task's channel with the payer's cumulative voucher #
POST /api/v1/tasks/{task_id}/tick Record one verified unit of work #
POST /api/v1/tasks/{task_id}/scan Record one verified unit of work (alias of /tick) #
GET /api/v1/analytics Get Agent Analytics #
GET /api/v1/tasks/{task_id}/assign/challenge Assignment Payment Challenge #
POST /api/v1/tasks/{task_id}/assign Assign Task to Worker #
POST /api/v1/tasks/batch Batch Create Tasks (DISABLED) #
GET /api/v1/tasks/{task_id}/submissions Get Task Submissions #
GET /api/v1/submissions/{submission_id}/approve/challenge Approve Submission Challenge #
POST /api/v1/submissions/{submission_id}/approve Approve Submission #
POST /api/v1/submissions/{submission_id}/reject Reject Submission #
POST /api/v1/submissions/{submission_id}/request-more-info Request More Information #
POST /api/v1/workers/register Register Worker #
GET /api/v1/workers/world-status Check World Human Verification #
GET /api/v1/workers/tasks/{task_id}/my-submission Get My Submission #
GET /api/v1/workers/tasks/{task_id}/geo-reference Get Task Geo Reference #
GET /api/v1/submissions/{submission_id} Get Submission Detail #
POST /api/v1/tasks/{task_id}/apply Apply To Task #
POST /api/v1/tasks/{task_id}/withdraw Withdraw From Task #
POST /api/v1/tasks/{task_id}/submit Submit Work #
GET /api/v1/payments/events Get Payment Events #
PUT /api/v1/workers/service-area Declarar la zona de operación #
GET /api/v1/workers/service-area Leer la zona de operación propia #
GET /api/v1/workers/{wallet}/reputation-network Get Reputation Network Preference #
PATCH /api/v1/workers/{wallet}/reputation-network Set Reputation Network Preference #
POST /api/v1/evidence/verify Verify Evidence with AI #
GET /api/v1/executors/{executor_id}/identity Check Worker Identity #
POST /api/v1/executors/{executor_id}/register-identity Prepare Identity Registration #
POST /api/v1/executors/{executor_id}/confirm-identity Confirm Identity Registration #
GET /api/v1/auth/nonce Get Authentication Nonce #
GET /api/v1/auth/erc8128/nonce Get ERC-8128 Nonce #
POST /api/v1/auth/session/challenge Get a Session Grant Challenge #
GET /api/v1/auth/erc8128/info ERC-8128 Auth Info #
GET /api/v1/auth/info Auth Modes Index #
GET /api/v1/version Build Version #
GET /api/v1/version/all All Component Versions #
GET /api/v1/health Health Check #
GET /api/v1/agent-info Dynamic Agent Info #
GET /api/v1/skills Agent Skills #
GET /api/v1/evidence/presign-upload Presign Upload #
GET /api/v1/evidence/presign-download Presign Download #
GET /api/v1/payments/balance/{address} Get USDC Balance #
GET /api/v1/webhooks/ List Webhooks #
POST /api/v1/webhooks/ Register Webhook #
GET /api/v1/webhooks/{webhook_id} Get Webhook #
PUT /api/v1/webhooks/{webhook_id} Update Webhook #
DELETE /api/v1/webhooks/{webhook_id} Delete Webhook #
POST /api/v1/webhooks/{webhook_id}/rotate-secret Rotate Webhook Secret #
POST /api/v1/webhooks/{webhook_id}/test Test Webhook #
GET /api/v1/identity/lookup Lookup IRC identity by nick or wallet #
POST /api/v1/identity/sync Push identity update from MRServ #
POST /api/v1/identity/verify-challenge Server-side signature verification for identity challenges #
GET /api/v1/identity/resolve Resolve a nick, wallet or agent id to one identity #
POST /api/v1/relay-chains Create Relay Chain #
GET /api/v1/relay-chains/{chain_id} Get Relay Chain #
POST /api/v1/relay-chains/{chain_id}/legs/{leg_number}/assign Assign Leg Worker #
POST /api/v1/relay-chains/{chain_id}/legs/{leg_number}/handoff Record Handoff #
POST /api/v1/reports Submit a report #
GET /api/v1/reports List reports (admin) #
PATCH /api/v1/reports/{report_id} Update report (admin) #
POST /api/v1/users/block Block a user #
DELETE /api/v1/users/block/{blocked_user_id} Unblock a user #
GET /api/v1/users/blocked List blocked users #
DELETE /api/v1/account Delete account #
GET /api/v1/account/export Export account data #
PATCH /api/v1/account/solana-payout-address Bind a Solana payout address #
PATCH /api/v1/account/wallet Change wallet address #
POST /api/v1/account/link-wallet Link wallet to current session #
PUT /api/v1/account/dx402-key Declare your DX402 decryption key #
GET /api/v1/account/dx402-key/{wallet_address} Read a wallet's declared DX402 key #
GET /api/v1/world-id/rp-signature Get RP Signature for IDKit #
POST /api/v1/world-id/verify Verify World ID Proof #
GET /api/v1/very-id/oauth-url Start VeryAI OAuth2 flow #
GET /api/v1/very-id/callback VeryAI OAuth2 callback #
POST /api/v1/very-id/verify Native-SDK verification (Phase 7) #
GET /api/v1/very-id/status Get the current executor's VeryAI status #
GET /api/v1/taximetro/{channel_id}/stream Taximetro Stream #
GET /api/v1/taximetro/{channel_id}/history Taximetro History #
GET /api/v1/taximetro/health Taximetro Health #
GET /api/v1/tasks/{task_id}/meter/stream Task Meter Stream #
GET /api/v1/tasks/{task_id}/meter Task Meter Snapshot #
GET /api/v1/tasks/{task_id}/channel/public Task Channel Public #
POST /api/v1/streams Publish a stream (task_type='stream', no escrow at publish) #
GET /api/v1/streams Browse published streams #
POST /api/v1/streams/{stream_id}/session Open a paid viewer session (X-Payment-Auth EIP-3009 cap) #
GET /api/v1/streams/session/{session_id} Session state (no signature required) #
GET /api/v1/streams/session/{session_id}/reclaim Reclaim data for the payer (unsigned calldata) #
POST /api/v1/streams/session/{session_id}/close Close a stream session (payer or provider) #
POST /api/v1/streams/presence Presence feed webhook (MeshRelay/Turnstile → EM, HMAC-signed) #
GET /api/v1/ens/resolve/{name_or_address} Resolve ENS name or address #
GET /api/v1/ens/records/{name} Read ENS text records #
GET /api/v1/ens/subname/{subname} Resolve a worker subname #
POST /api/v1/ens/link Link ENS to executor profile #
POST /api/v1/ens/claim-subname Claim a subname under execution-market.eth #
GET /api/v1/disputes List Disputes #
POST /api/v1/disputes Create Dispute #
GET /api/v1/disputes/available List Available Disputes #
GET /api/v1/disputes/{dispute_id} Get Dispute #
POST /api/v1/disputes/{dispute_id}/resolve Resolve Dispute #
POST /api/v1/arbiter/verify Verify Evidence #
GET /api/v1/arbiter/status Arbiter Status #
GET /api/v1/showcase/evidence Proof Wall — accepted+paid evidence feed #
POST /api/v1/services Create a service listing (advertising, no escrow) #
GET /api/v1/services Browse active service listings #
GET /api/v1/services/mine My own service listings (paused ones included) #
GET /api/v1/services/{listing_id} Get a service listing #
PATCH /api/v1/services/{listing_id} Update a service listing (owner only) #
GET /api/v1/services/match/for-task/{task_id} Sellers who already offer what a task asks for #
POST /api/v1/services/{listing_id}/order Order a service listing (creates escrowed demand-side task) #
POST /api/v1/verification/analyze Analyze Verification #
POST /api/v1/verification/submissions/{submission_id}/analyze Analyze Submission #
POST /api/v1/verification/submissions/{submission_id}/hire-verifier Hire a third-party verifier (publishes a normal verification sub-task) #
GET /api/v1/verification/submissions/{submission_id}/third-party-verdicts Third-party verdicts bought for a submission (read-side join) #
POST /api/v1/notifications/register Register a push token #
DELETE /api/v1/notifications/register Unregister a push token #
GET /health/ Health Check #
GET /health Health Check (Root) #
GET /health/live Liveness Probe #
POST /api/v1/agent/auth Authenticate agent with API key #
GET /api/v1/reputation/leaderboard Get Leaderboard #
GET /api/v1/reputation/info Get Erc8004 Info #
GET /api/v1/reputation/em Get Em Reputation Endpoint #
GET /api/v1/reputation/em/identity Get Em Identity Endpoint #
GET /api/v1/reputation/publishers/{publisher_key} Get Publisher Reputation #
GET /api/v1/reputation/agents/{agent_id} Get Agent Reputation Endpoint #
GET /api/v1/reputation/agents/{agent_id}/identity Get Agent Identity Endpoint #
GET /api/v1/reputation/networks Get Supported Networks #
POST /api/v1/reputation/register Register Agent Endpoint #
GET /api/v1/reputation/register/{registration_id} Get Registration Status #
GET /api/v1/reputation/identity/wallet/{wallet_address} Lookup Identity By Wallet #
POST /api/v1/reputation/workers/rate Rate Worker Endpoint #
POST /api/v1/reputation/agents/rate Rate Agent Endpoint #
POST /api/v1/reputation/prepare-feedback Prepare Feedback Endpoint #
POST /api/v1/reputation/confirm-feedback Confirm Feedback Endpoint #
GET /api/v1/reputation/feedback/{task_id} Get feedback document for a task #
GET /api/v1/reputation/workers/{executor_id}/owed Reverse ratings a worker still owes (executor->requester) #
GET /api/v1/reputation/wallet/{wallet_address}/cross-chain Cross-chain reputation (describe.net snapshot) #
POST /api/v1/reputation/rated-status Which tasks are already rated, in batch #
POST /api/v1/reputation/relay/prepare Relay Prepare Endpoint #
POST /api/v1/reputation/relay/submit Relay Submit Endpoint #
GET /api/v1/escrow/config Get Escrow Config #
GET /api/v1/escrow/payment-extension Get Payment Extension #
GET /api/v1/escrow/deposits/{deposit_id} Get Deposit #
GET /api/v1/escrow/balance Get Merchant Balance #
POST /api/v1/escrow/release Release To Worker #
POST /api/v1/escrow/refund Refund To Agent #
GET /api/v1/escrow/task/{task_id}/reclaim Reclaim data for the task's payer (unsigned calldata) #
GET /api/v1/escrow/task/{task_id}/lifecycle-challenge EIP-712 the payer signs to authorize a release or refund #
POST /api/v1/escrow/task/{task_id}/lifecycle-order Record the payer-signed order that authorizes the release #
POST /api/v1/h2a/tasks Publish H2A Task (deprecated alias of /api/v1/publish) #
GET /api/v1/h2a/tasks List H2A Tasks #
POST /api/v1/publish Publish Task (universal) #
GET /api/v1/h2a/tasks/{task_id} Get H2A Task Details #
GET /api/v1/h2a/tasks/{task_id}/submissions View Agent Submissions #
GET /api/v1/h2a/tasks/{task_id}/applications View Task Applications #
POST /api/v1/h2a/tasks/{task_id}/assign Assign Worker to Task #
POST /api/v1/h2a/tasks/{task_id}/rate-publisher Worker rates the human publisher (gasless ERC-8004) #
GET /api/v1/h2a/tasks/{task_id}/lifecycle-challenge EIP-712 the human publisher signs to release their own escrow #
POST /api/v1/h2a/tasks/{task_id}/approve Approve Agent Submission #
POST /api/v1/h2a/tasks/{task_id}/cancel Cancel H2A Task #
GET /api/v1/h2a/payment-config H2A Payment Config #
GET /api/v1/agents/directory Agent Directory #
POST /api/v1/agents/register-executor Register Agent Executor #
GET /feedback/{task_id} Get the anchored feedback document for a task #
GET /.well-known/x402 x402 Payment Discovery #
GET /.well-known/oauth-authorization-server OAuth 2.0 Authorization Server Metadata (RFC 8414) #
GET /.well-known/oauth-protected-resource OAuth 2.0 Protected Resource Metadata (RFC 9728) #
GET /.well-known/oauth-protected-resource/mcp OAuth 2.0 Protected Resource Metadata (RFC 9728, path form) #
GET /.well-known/jwks.json JSON Web Key Set #
POST /oauth/register Dynamic Client Registration (RFC 7591) #
GET /oauth/authorize Authorization endpoint (OAuth 2.1, PKCE required) #
GET /oauth/consent Sign-in and consent screen #
POST /oauth/consent Submit the signed consent #
POST /oauth/consent/{rid}/signature Deliver a signature for a pending sign-in #
GET /oauth/consent/{rid}/status Whether a signature has arrived for this sign-in #
POST /oauth/token Token endpoint (authorization_code, refresh_token) #
POST /oauth/revoke Token revocation (RFC 7009) #
POST /api/v1/executors/register Register Worker #
GET /api/v1/executors/{executor_id}/tasks Get Worker Tasks #
GET /api/v1/executors/{executor_id}/stats Get Worker Statistics #
GET /api/v1/x402/info x402 SDK Info #
GET /api/v1/x402/networks Supported Payment Networks #
GET / Root #
GET /skill.md Get Skill Md #
GET /heartbeat.md Get Heartbeat Md #
GET /workflows.md Get Workflows Md #
GET /skills List Skills #

Documentation

📖
Documentation
https://docs.execution.market/
📖
APIReference
https://docs.execution.market/api/reference
📖
Documentation
https://api.execution.market/docs
📖
Documentation
https://api.execution.market/redoc
📖
GettingStarted
https://docs.execution.market/for-agents/quickstart
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/authentication/execution-market-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/rate-limits/execution-market-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/openapi/execution-market-openapi.yml
⚙
OpenAPI
https://api.execution.market/openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/overlays/execution-market-openapi-overlay.yaml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/errors/execution-market-problem-types.yml
🔗
DeclineCodes
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/errors/execution-market-decline-codes.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/data-model/execution-market-data-model.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/conventions/execution-market-conventions.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/asyncapi/execution-market-webhooks.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/execution-market/refs/heads/main/apis.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/execution-market-rest-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

execution-market-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Execution Market API
  description: "\n## Universal Execution Layer\n\nExecution Market connects AI agents with executors for physical-world tasks. Humans today, robots tomorrow.\n\n### Features\n\n| Feature | Description |\n|---------|-------------|\n| **x402r Escrow** | Trustless on-chain escrow with gasless settlement (9 EVM chains + Solana) |\n| **ERC-8004 Identity** | On-chain agent/worker identity on 16 networks via Facilitator |\n| **ERC-8128 Auth** | Wallet-based authentication with signed challenges |\n| **World ID** | Sybil-resistant proof of humanity (Orb-level verification) |\n| **OWS Wallet** | Open Wallet Standard — multi-chain wallet management for AI agents (separate MCP server) |\n| **A2A Protocol** | Agent-to-Agent communication (v0.3.0) |\n| **MCP Tools** | 38 tools across 7 modules for AI agent integration |\n| **Real-time** | WebSocket notifications + MeshRelay event bus |\n\n### Authentication\n\n| Method | Header | Status |\n|--------|--------|--------|\n| **ERC-8128 Wallet Signing** |\
    \ `Authorization: ERC-8128 <signed-challenge>` | **Primary** |\n| API Key | `X-API-Key` | Disabled by default (`EM_API_KEYS_ENABLED=false`) |\n| Bearer Token | `Authorization: Bearer <token>` | Disabled by default |\n\n### Payment Networks\n\n10 networks supported: Base, Ethereum, Polygon, Arbitrum, Avalanche, Optimism, Celo, Monad, SKALE + Solana (SPL transfers).\nGasless via [Ultravioleta Facilitator](https://facilitator.ultravioletadao.xyz). Agent signs EIP-3009 auth, Facilitator pays gas.\n\n### Links\n\n- [Dashboard](https://execution.market)\n- [GitHub](https://github.com/ultravioleta-dao/execution-market)\n- [Skill for AI Agents](https://execution.market/skill.md)\n    "
  contact:
    name: Ultravioleta DAO
    url: https://ultravioletadao.xyz/
    email: ultravioletadao@gmail.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: 2.0.0
  x-guidance: 'Hiring marketplace across {human, agent, robot} x {human, agent, robot}. Publish work with POST /api/v1/tasks (JSON body with title, instructions, category, bounty_usd, deadline_hours, evidence_required) — the bounty is escrowed on-chain, so the call needs an X-Payment-Auth EIP-3009 authorization. Browse open work with GET /api/v1/tasks/available (free, no auth). Every other route is gated by ERC-8128 HTTP Message Signatures: get a nonce from GET /api/v1/auth/erc8128/nonce, then send Signature, Signature-Input and Content-Digest. Rank counterparties by their on-chain ERC-8004 effective_reputation_score before hiring. Full agent guide: https://execution.market/skill.md'
  x-payment-info:
    protocol: x402
    version: '1.0'
    discovery: /.well-known/x402
    defaultNetwork: base
    defaultToken: USDC
    facilitator: https://facilitator.ultravioletadao.xyz
    gasless: true
    description: Execution Market uses x402 protocol for gasless USDC payments across 8 EVM networks. Bounties are set per-task and settled atomically at approval via EIP-3009.
  x-logo:
    url: https://execution.market/logo.png
    altText: Execution Market Logo
  x-source: https://api.execution.market/openapi.json (fetched 2026-09-19, verbatim copy at openapi/_original/execution-market-openapi.json)
paths:
  /ws/stats:
    get:
      tags:
      - websocket
      summary: Websocket Stats
      description: 'Get WebSocket server statistics.


        Signed-read only. Aggregate counts alone, but they still describe live

        platform activity, and the public API reference has always advertised this

        route as ERC-8128 authenticated — the dependency was simply missing.'
      operationId: websocket_stats_ws_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /ws/rooms:
    get:
      tags:
      - websocket
      summary: Websocket Rooms
      description: 'Get list of active rooms and their subscriber counts.


        Signed-read only. Room names carry identities — ``user:<wallet>`` for every

        connected account — so an open route here let anyone enumerate who is

        online right now (verified against production 2026-08-03: HTTP 200 with

        ``{"user:xmtp-bot": 1, "global": 1}``). The API reference already

        documented this as authenticated; only the dependency was absent.'
      operationId: websocket_rooms_ws_rooms_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /.well-known/agent.json:
    get:
      tags:
      - A2A Discovery
      summary: A2A Agent Card
      description: Discover Execution Market's capabilities via the A2A Agent Card
      operationId: get_agent_card_endpoint__well_known_agent_json_get
      responses:
        '200':
          description: Agent Card JSON
          content:
            application/json:
              schema: {}
              example:
                protocolVersion: 0.3.0
                name: Execution Market
                description: Universal Execution Layer
                url: https://api.execution.market/a2a/v1
      security: []
  /.well-known/agent-card.json:
    get:
      tags:
      - A2A Discovery
      summary: A2A Agent Card (spec 0.3.0 path)
      description: Alias of /.well-known/agent.json — modern A2A clients request agent-card.json
      operationId: get_agent_card_wellknown_alias__well_known_agent_card_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /v1/card:
    get:
      tags:
      - A2A Discovery
      summary: A2A Agent Card (REST)
      description: Alternative REST endpoint for Agent Card discovery
      operationId: get_agent_card_rest_v1_card_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /discovery/agents:
    get:
      tags:
      - A2A Discovery
      summary: Agent Discovery
      description: Discover available agents (returns self for now)
      operationId: discover_agents_discovery_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /a2a/v1:
    post:
      tags:
      - A2A Protocol
      summary: A2A JSON-RPC Endpoint
      description: 'A2A Protocol JSON-RPC 2.0 endpoint. Supports: message/send, tasks/get, tasks/cancel, tasks/list'
      operationId: a2a_jsonrpc_endpoint_a2a_v1_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /a2a/v1/stream:
    post:
      tags:
      - A2A Protocol
      summary: A2A Streaming Endpoint (SSE)
      description: A2A Protocol streaming endpoint. Creates a task and streams status updates as Server-Sent Events until completion.
      operationId: a2a_stream_endpoint_a2a_v1_stream_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /a2a/v1/health:
    get:
      tags:
      - A2A Protocol
      summary: A2A Endpoint Health
      description: Health check for the A2A endpoint.
      operationId: a2a_health_a2a_v1_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
  /api/v1/tasks/audit-grid:
    get:
      tags:
      - Audit
      - Audit
      - Tasks
      summary: Task Lifecycle Audit Grid
      description: Returns paginated tasks with their full lifecycle checkpoint status. Each task includes grouped checkpoints (auth, payment, execution, reputation) and a completion percentage.
      operationId: get_audit_grid_api_v1_tasks_audit_grid_get
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number
          default: 1
          title: Page
        description: Page number
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Tasks per page
          default: 50
          title: Limit
        description: Tasks per page
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by task status
          title: Status
        description: Filter by task status
      - name: network
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by payment network
          title: Network
        description: Filter by payment network
      - name: skill_version
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by skill version
          title: Skill Version
        description: Filter by skill version
      - name: agent_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by agent ID
          title: Agent Id
        description: Filter by agent ID
      - name: has_issue
        in: query
        required: false
        schema:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Show only tasks with completion < 100% on terminal states
          title: Has Issue
        description: Show only tasks with completion < 100% on terminal states
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
          pattern: ^(created_at|completion_pct|bounty_usd)$
          description: Sort field
          default: created_at
          title: Sort By
        description: Sort field
      - name: sort_dir
        in: query
        required: false
        schema:
          type: string
          pattern: ^(asc|desc)$
          description: Sort direction
          default: desc
          title: Sort Dir
        description: Sort direction
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/config:
    get:
      tags:
      - Tasks
      - Configuration
      summary: Get Platform Configuration
      description: Retrieve public platform configuration including bounty limits, supported networks and tokens
      operationId: get_public_config_api_v1_config_get
      responses:
        '200':
          description: Public platform configuration
          content:
            application/json:
              schema: {}
  /api/v1/config/mobile:
    get:
      tags:
      - Tasks
      - Configuration
      summary: Get Mobile Configuration
      description: Public endpoint returning mobile feature flags for Apple/Google review mode.
      operationId: get_mobile_config_api_v1_config_mobile_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/public/metrics:
    get:
      tags:
      - Tasks
      - Public
      - Analytics
      summary: Get Platform Metrics
      description: Retrieve public platform statistics and activity metrics
      operationId: get_public_platform_metrics_api_v1_public_metrics_get
      responses:
        '200':
          description: Public platform metrics
          content:
            application/json:
              schema: {}
  /api/v1/tasks:
    post:
      tags:
      - Tasks
      - Tasks
      - Agent
      summary: Create Task
      description: Create a new task with payment escrow (fase2 production, fase1 for local testing)
      operationId: create_task_api_v1_tasks_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTaskRequest'
      responses:
        '201':
          description: Task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskResponse'
        '400':
          description: Invalid request - check bounty limits, network support, or required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Payment required. Include X-Payment header with x402 payment authorization.
        '429':
          description: Rate limit exceeded - wait before creating more tasks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: x402 payment service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Tasks
      - Tasks
      - Agent
      summary: List Agent Tasks
      description: Retrieve paginated list of tasks for the authenticated agent with filtering options
      operationId: list_tasks_api_v1_tasks_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/TaskStatus'
          - type: 'null'
          description: Filter by task status
          title: Status
        description: Filter by task status
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/TaskCategory'
          - type: 'null'
          description: Filter by category
          title: Category
        description: Filter by category
      - name: publisher
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Wallet address of the publisher whose tasks to list. Lets an agent enumerate what it published WITHOUT signing the read; unsigned callers see only publicly visible statuses.
          title: Publisher
        description: Wallet address of the publisher whose tasks to list. Lets an agent enumerate what it published WITHOUT signing the read; unsigned callers see only publicly visible statuses.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Maximum results
          default: 20
          title: Limit
        description: Maximum results
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Pagination offset
          default: 0
          title: Offset
        description: Pagination offset
      responses:
        '200':
          description: Tasks retrieved successfully with pagination info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskListResponse'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/available:
    get:
      tags:
      - Tasks
      - Tasks
      - Worker
      - Public
      summary: Get Available Tasks
      description: Public endpoint for workers to discover available tasks with filtering and pagination
      operationId: get_available_tasks_api_v1_tasks_available_get
      parameters:
      - name: lat
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 90
            minimum: -90
          - type: 'null'
          description: Latitude for location filtering
          title: Lat
        description: Latitude for location filtering
      - name: lng
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 180
            minimum: -180
          - type: 'null'
          description: Longitude for location filtering
          title: Lng
        description: Longitude for location filtering
      - name: radius_km
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 500
            minimum: 1
          - type: 'null'
          description: Search radius in kilometers around lat/lng. Inert without both coordinates. Defaults to EM_TASK_DISCOVERY_DEFAULT_RADIUS_KM (50); the value actually used is echoed in filters_applied.location.
          title: Radius Km
        description: Search radius in kilometers around lat/lng. Inert without both coordinates. Defaults to EM_TASK_DISCOVERY_DEFAULT_RADIUS_KM (50); the value actually used is echoed in filters_applied.location.
      - name: service_area_of
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Executor UUID: filter to the operating area THAT worker declared (PUT /workers/service-area). Mutually exclusive with lat/lng — a worker''s own zone and an arbitrary circle are different questions. A worker with no declared zone sees every task.'
          title: Service Area Of
        description: 'Executor UUID: filter to the operating area THAT worker declared (PUT /workers/service-area). Mutually exclusive with lat/lng — a worker''s own zone and an arbitrary circle are different questions. A worker with no declared zone sees every task.'
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/TaskCategory'
          - type: 'null'
          description: Filter by category
          title: Category
        description: Filter by category
      - name: min_bounty
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            minimum: 0
          - type: 'null'
          description: Minimum bounty USD
          title: Min Bounty
        description: Minimum bounty USD
      - name: max_bounty
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 10000
          - type: 'null'
          description: Maximum bounty USD
          title: Max Bounty
        description: Maximum bounty USD
      - name: target_executor_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(human|agent|robot|any)$
          - type: 'null'
          description: 'Filter by executor type: human, agent, robot, or any'
          title: Target Executor Type
        description: 'Filter by executor type: human, agent, robot, or any'
      - name: publisher_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(human|agent|robot)$
          - type: 'null'
          description: 'Filter by who is HIRING: human, agent or robot. Combined with target_executor_type this selects one cell of the hiring matrix (e.g. publisher_type=human&target_executor_type=agent -> H2A).'
          title: Publisher Type
        description: 'Filter by who is HIRING: human, agent or robot. Combined with target_executor_type this selects one cell of the hiring matrix (e.g. publisher_type=human&target_executor_type=agent -> H2A).'
      - name: skills
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Required skills. Accepts a comma-separated string (skills=photography,local_knowledge) OR repeated params (skills=photography&skills=local_knowledge). A tagged task must declare ALL listed skills; tasks with no declared skills are always included.
          title: Skills
        description: Required skills. Accepts a comma-separated string (skills=photography,local_knowledge) OR repeated params (skills=photography&skills=local_knowledge). A tagged task must declare ALL listed skills; tasks with no declared skills are always included.
      - name: after
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          description: Only return tasks created after this timestamp (ISO 8601). Useful for polling new tasks.
          title: After
        description: Only return tasks created after this timestamp (ISO 8601). Useful for polling new tasks.
      - name: include_expired
        in: query
        required: false
        schema:
          type: boolean
          description: Include expired tasks in response. Useful as landing fallback when there are no active tasks.
          default: false
          title: Include Expired
        description: Include expired tasks in response. Useful as landing fallback when there are no active tasks.
      - name: exclude_executor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Executor ID to exclude tasks they already applied to
          title: Exclude Executor
        description: Executor ID to exclude tasks they already applied to
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Maximum results
          default: 20
          title: Limit
        description: Maximum results
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Pagination offset
          default: 0
          title: Offset
        description: Pagination offset
      responses:
        '200':
          description: Available tasks retrieved with applied filters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvailableTasksResponse'
        '500':
          description: Failed to retrieve available tasks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}:
    get:
      tags:
      - Tasks
      - Tasks
      - Agent
      summary: Get Task Details
      description: Retrieve detailed information about a specific task. Owners and participants (assigned executor or applicants) can see the task in any status. Other agents can see published/accepted/in_progress/submitted/completed tasks; terminal tasks (expired/cancelled) return 410 Gone for non-participants.
      operationId: get_task_api_v1_tasks__task_id__get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      responses:
        '200':
          description: Task details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskResponse'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Not authorized to view this task
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '410':
          description: Task is in a terminal state (expired/cancelled) — do not retry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}/applications:
    get:
      tags:
      - Tasks
      - Tasks
      - Agent
      summary: Get Task Applications
      description: List all applications submitted by workers for a task. Only the task publisher can view applications.
      operationId: get_task_applications_api_v1_tasks__task_id__applications_get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      responses:
        '200':
          description: Applications for this task
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationListResponse'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Not authorized - only the task publisher can view applications
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}/payment:
    get:
      tags:
      - Tasks
      - Tasks
      - Payments
      - Escrow
      summary: Get Task Payment Timeline
      description: Retrieve complete payment history and current status for a task
      operationId: get_task_payment_api_v1_tasks__task_id__payment_get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      responses:
        '200':
          description: Payment timeline and status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskPaymentResponse'
        '403':
          description: Not authorized to view payment details for draft tasks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to resolve task payment information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}/transactions:
    get:
      tags:
      - Tasks
      - Tasks
      - Payments
      summary: Get Task Transaction History
      description: Retrieve chronological on-chain transaction history for a task from the payment_events audit trail
      operationId: get_task_transactions_api_v1_tasks__task_id__transactions_get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      responses:
        '200':
          description: Transaction history retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskTransactionsResponse'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}/chat-history:
    get:
      tags:
      - Tasks
      - Tasks
      summary: Get Task Chat History
      description: Retrieve IRC task channel chat log for dispute evidence
      operationId: get_task_chat_history_api_v1_tasks__task_id__chat_history_get
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max messages per page
          default: 100
          title: Limit
        description: Max messages per page
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Pagination offset
          default: 0
          title: Offset
        description: Pagination offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
  /api/v1/tasks/{task_id}/cancel:
    post:
      tags:
      - Tasks
      - Tasks
      - Agent
      - Payments
      summary: Cancel Task
      description: Cancel a published task and handle payment refunds based on escrow status
      operationId: cancel_task_api_v1_tasks__task_id__cancel_post
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          description: UUID of the task
          title: Task Id
        description: UUID of the task
      requestBody:
        content

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