https://github.com/alexar76/aimarket-protocol

AIMarket Protocol v2 — open specs, JSON schemas, and test vectors.
https://github.com/alexar76/aimarket-protocol

ai-agents aimarket api-spec interoperability json-schema open-source protocol

Last synced: 1 day ago
JSON representation

AIMarket Protocol v2 — open specs, JSON schemas, and test vectors.

• Host: GitHub
• URL: https://github.com/alexar76/aimarket-protocol
• Owner: alexar76
• License: mit
• Created: 2026-05-22T17:37:36.000Z (8 days ago)
• Default Branch: main
• Last Pushed: 2026-05-29T20:46:00.000Z (1 day ago)
• Last Synced: 2026-05-29T21:18:49.781Z (1 day ago)
• Topics: ai-agents, aimarket, api-spec, interoperability, json-schema, open-source, protocol
• Language: Python
• Size: 36.1 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md
  • Roadmap: ROADMAP.md

Awesome Lists containing this project

README

          

> **Mirror — read-only.**

> The canonical source for `aimarket-protocol` lives in the AI-Factory monorepo.

> Open issues and PRs at `Superowner/aicom`; commits pushed here are

> overwritten by `scripts/mirror_satellites.sh` on the next sync run.

> See `docs/repository-canonical-policy.md` for the policy.

# AIMarket Protocol v2 — Federation

[![CI](https://github.com/alexar76/aimarket-protocol/actions/workflows/ci.yml/badge.svg)](https://github.com/alexar76/aimarket-protocol/actions/workflows/ci.yml)

[![Release](https://img.shields.io/github/v/release/alexar76/aimarket-protocol?include_prereleases&label=release)](https://github.com/alexar76/aimarket-protocol/releases)

> **Ecosystem:** [AICOM overview & live demos](https://alexar76.github.io/aicom/) · **Package version:** `0.1.0` ([VERSION](VERSION))

**Status:** Draft v2.0.0  

## Documents

| Document | Description |

|----------|-------------|

| [spec.md](spec.md) | Full protocol specification (RFC-style) |

| [ecosystem.md](ecosystem.md) | **Ecosystem map** — Mermaid diagrams (topology, invoke, federation, plugins) |

| [schemas/well-known.json](schemas/well-known.json) | JSON Schema for `.well-known/ai-market.json` |

| [schemas/manifest.json](schemas/manifest.json) | JSON Schema for capability manifest |

| [schemas/receipt.json](schemas/receipt.json) | JSON Schema for signed receipts |

| [schemas/federation-announce.json](schemas/federation-announce.json) | Federation announcement message |

| [test-vectors/](test-vectors/) | Reference test vectors for signature verification |

## Live Reference Implementation

**[modelmarket.dev](https://modelmarket.dev)** — production hub running this protocol:

| Resource | URL |

|----------|-----|

| .well-known | [modelmarket.dev/.well-known/ai-market.json](https://modelmarket.dev/.well-known/ai-market.json) |

| Widget demo | [modelmarket.dev/widget/demo](https://modelmarket.dev/widget/demo) |

| AI Economy live | [modelmarket.dev/live](https://modelmarket.dev/live) |

| Integration examples | [modelmarket.dev/examples](https://modelmarket.dev/examples) |

## Quick Start

```bash

# Live hub:

curl https://modelmarket.dev/.well-known/ai-market.json

# Federated search:

curl "https://modelmarket.dev/ai-market/v2/search?intent=translate&budget=3.00"

# Open channel + invoke + close:

CH=$(curl -s -X POST https://modelmarket.dev/ai-market/v2/channel/open \

  -H "Content-Type: application/json" \

  -d '{"deposit_usd":3.0}' | jq -r '.channel.channel_id')

curl -X POST https://modelmarket.dev/ai-market/v2/invoke \

  -H "X-Payment-Channel: $CH" \

  -d '{"product_id":"prod-translate","capability_id":"translate.multi@v2","source_hub":"local","input":{"text":"hello"}}'

curl -X POST https://modelmarket.dev/ai-market/v2/channel/close \

  -d "{\"channel_id\":\"$CH\"}"

```

## Protocol Versions

| Version | Scope |

|---------|-------|

| v1 | Single marketplace: .well-known, MCP manifest, 402 flow, channels, pipelines |

| v2 | Federation: cross-hub crawl, index, search, route, reputation |