For Machines
One canonical commercial institution, two audiences. The same products humans read about are discoverable, payable and dependable for software: stable schemas, exact prices, one payment wallet, signed receipts and webhooks that replace polling.
Discovery, quote, payment, delivery and repeat use share one canonical catalog and one receipt chain; the payment address is advertised by the canonical x402 surface, never copied into this page.
Discovery surfaces
| Path | What it is |
|---|---|
/openapi.json | OpenAPI. Canonical HTTP contract with operation ids, schemas, errors and payment semantics. served by: machine-discovery |
/catalog.json | Catalog. The canonical product index: ids, versions, prices, schemas and availability. served by: machine-discovery |
/feed.json | Product feed. Compact versioned change feed for product availability and price changes. served by: machine-discovery |
/llms.txt | llms.txt. Curated machine-readable navigation for systems that read it; not a search lever. served by: machine-discovery |
/.well-known/agent-card.json | A2A Agent Card. Public Agent Card: endpoint, auth, capabilities and skills. served by: machine-discovery |
/mcp/server.json | MCP server metadata. MCP transport and discovery metadata for eligible tools. served by: machine-discovery |
/x402/bazaar.json | x402 Bazaar records. The discovery records published for x402 Bazaar indexes. served by: machine-discovery |
/api/x402/.well-known | x402 discovery. The payable product routes. An unpaid POST to /api/x402/{productId} answers 402 with an x402 v2 offer; every route resolves to the canonical x402 Revenue Collection Wallet. served by: canonical-api |
/docs/index.json | Product docs index. Stable operation ids, schemas, errors and payment semantics, one document per product. served by: machine-discovery |
/.well-known/did.json | Service identity. did:web service identity and the authorized receipt signing key, when used. served by: machine-discovery |
/.well-known/security.txt | Security contact. Security contact and disclosure policy. served by: public-web |
/api/public/performance | Track record. Arbiter's live P&L, every committed forecast with its score, and every decision cycle, computed from durable records. Free, read-only, no account; settled trades, forecasts and decisions also page separately under the same prefix. served by: canonical-api |
/performance/feed.json | Track-record feed. JSON Feed 1.1 of settled live trades, scored forecasts (misses included) and daily decision digests; the same items as RSS at /performance/feed.xml. served by: canonical-api |
How paying works (x402)
- Every inbound commercial route resolves to the canonical x402 Revenue Collection Wallet; the address is advertised by the payable surface itself, and the wallet's private key never enters any public system.
- Retries use a logical Payment-Identifier, so a network failure or a restart cannot cause duplicate payment processing, duplicate work or duplicate delivery.
- Offers and receipts are signed with a dedicated signing key that is separate from the payment wallet; the service identity is published at
/.well-known/did.json. - Discovery starts at
/api/x402/.well-known, which lists the payable routes; an unpaidPOST /api/x402/{productId}answers 402 with the x402 v2 offer, and the paid retry of the same call is the purchase. The records published for x402 Bazaar indexes are at/x402/bazaar.json. - Wrong chain, wrong asset, wrong address, a stale quote, a duplicate payment id or uncertain finality fails closed - the honest failure is part of the contract.
Webhooks
- Material events - changes, risk-state changes, product-version changes, completed jobs, ready data - are built to be delivered to you instead of polled: subscriptions are an explicit buyer action, never automatic enrolment.
- Deliveries are signed with timestamps and unique event ids, protected against replay, restricted to safe https destinations, retried with bounded backoff and moved to dead-letter receipts when they keep failing. A no-material-change window never generates a storm.
- Subscriptions are not open yet. The earlier subscribe, list and cancel calls identified a buyer by a customer key alone, which is not a credential, so they are closed (they answer 410) until subscriptions move behind authenticated accounts. Paid x402 purchases and every discovery document are unaffected.
Feeds
Humans and machines can follow Arbiter without an account:RSS,JSON Feed, and thesitemap (with the news sitemap for the last two days and the image sitemap beside it).
Human-readable docs and contact
The service pages explain each product in plain language with its exact canonical id, version and price. Integration questions, security reports and rights requests go toArbiteroperations@gmail.com; security disclosure policy is published at/.well-known/security.txt.
Every path on this page is served on this site: compiled from canonical contracts by the edge machine-discovery and indexing-publisher services, or answered by the canonical API itself. This page links and explains only - it never fabricates an endpoint, a payload, a wallet address or a credential.
