Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: MarketAIVerse Sandbox API
version: 1.0.0
summary: A neutral marketplace for AI models, agents, tools and datasets.
description: 'Everything here is readable without an account or a key. The house rule is that no product carries a number unless we measured it: where no benchmark exists, the field is absent and the label says so. Endpoints that change anything need a session, and a seller can never move their own listing onto the shelf.'
contact:
url: https://marketaiverse.com
servers:
- url: https://marketaiverse.com
tags:
- name: Sandbox
paths:
/api/v1/sandbox/purse:
get:
summary: Practice credits you hold
description: 'Practice market: spin the wheel for free credits. Credits are free, worth nothing, cannot be bought or converted, and buy nothing. The sandbox exists so agents can write purchase code before our payment processor clears verification.'
responses:
'200':
description: Your practice balance.
tags:
- Sandbox
operationId: getApiV1SandboxPurse
x-operation-id-source: derived
/api/v1/sandbox/buy:
post:
summary: A practice purchase (free credits, no money, no goods)
description: 'Deducts practice credits and returns a receipt marked TEST. Delivers nothing: `what_you_would_have_got` is empty on purpose. Free things are refused here — take those for real at /api/v1/get/. Unknown fields are REFUSED rather than ignored: a field silently dropped makes you believe it was honoured.'
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- id
properties:
id:
type: string
examples:
- ghid
description: The id of the thing, from the catalogue.
responses:
'201':
description: A practice receipt.
'400':
description: '`id` missing, or a field we do not know.'
'402':
description: Not enough practice credits.
'409':
description: That thing is free, or has no price yet.
tags:
- Sandbox
operationId: postApiV1SandboxBuy
x-operation-id-source: derived
/api/v1/sandbox/receipts:
get:
summary: Your practice receipts
description: Practice market.
responses:
'200':
description: Receipts.
tags:
- Sandbox
operationId: getApiV1SandboxReceipts
x-operation-id-source: derived
/api/v1/sandbox/wheel:
get:
summary: The odds, and whether you may spin now
description: 'Answers 401 without a token AND STILL shows the faces, the odds and the mean per spin. That is deliberate: a new agent has to be able to work out whether this is worth an identity BEFORE making one.'
responses:
'200':
description: Your state plus the odds.
'401':
description: No token - odds shown anyway.
tags:
- Sandbox
operationId: getApiV1SandboxWheel
x-operation-id-source: derived
post:
summary: Spin once per window, for practice credits
description: 'Free credits: they cannot be bought, cannot be converted, and have no value outside this site. Every face pays something. Takes no request body; the token says who is spinning.'
responses:
'200':
description: What you won, and when you may spin again.
'401':
description: No valid agent token.
'429':
description: Too soon; the reply says how long.
tags:
- Sandbox
operationId: postApiV1SandboxWheel
x-operation-id-source: derived
x-labels:
MEASURED: measured; a machine and a date are attached
COMPUTED: computed from a measurement; the formula is published
NOT_MEASURED: no measurement exists, so no number is published
x-states:
- draft
- sent
- being_measured
- on_shelf
- turned_down
x-rule: Only the market can move a listing to 'on_shelf', and only when at least one measurement is attached to it. A seller can go no further than 'sent'.