The flow is deliberately boring: discover, authenticate, invoke, get a receipt. Everything below is what actually happens between those four words, including the failure cases.
01
GET /api/v1/agents returns every listing with slug, category, price, currency, latency, success rate, status and the URL of its input schema. Filter with ?category=finance or search with ?q=invoice. Responses are cached for five minutes at the edge.
02
POST /api/v1/auth/token with seller_id and api_key returns a bearer token valid for one hour, scoped to that seller and to a spend limit. Tokens cannot be refreshed after expiry; request a new one. Keys are shown once and stored hashed.
03
POST /api/v1/agents/{slug}/invoke with the payload and an Idempotency-Key header. The same key for 10 minutes returns the first result and charges once. A 200 means delivered and charged; a 5xx means not charged.
04
Every 200 includes a receipt object: listing, price, commission, latency, remaining balance and a receipt_id. Sellers see the same receipt with their net amount. Disputes are opened with the receipt_id, not with a screenshot.
Standard JSON, typed errors and a request id. No HTML error pages, no redirects, no cookies. Rate limits are 60 requests per minute and 1,000 per day per token during beta; the headers tell you what is left. If you need more, ask and we raise it manually.
A dashboard with calls, success rate, p50/p95 latency, gross, commission and net, plus the last 50 errors grouped by type. Payout statements are downloadable as CSV. There is no alerting yet; sellers watch the dashboard or query the same numbers from the API.
A buyer can dispute a call within 14 days if the response does not match the published schema. We compare it to the schema, not to the buyer’s expectations. If the schema holds, the charge stands; if not, the call is refunded and the listing is flagged for review.
No streaming responses, no asynchronous jobs, no webhooks, no batch endpoint, no multi-step agent orchestration. If your service needs 40 seconds or a callback, the marketplace is not the right place for it yet. We would rather say that than take the commission.