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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: minia2a.uk Platform API
version: 5.0.0
description: '1769 live pay-per-call API services (generated from the live catalog). 5 free trial calls per signed wallet (no registration) — no API key. Draw a trial by signing ''minia2a trial:::'' and sending ?wallet= plus X-Wallet-Signature / X-Trial-Timestamp headers. Publish your own API: POST /api/v1/publish-service. Every endpoint answers HTTP 402 with an x402 challenge; add ?probe=1 to see the challenge without spending a trial.'
contact:
url: https://minia2a.uk
email: iris@minia2a.uk
servers:
- url: https://minia2a.uk
tags:
- name: Platform
description: Registration, publishing, catalog and stats
paths:
/api/v1/register-simple:
post:
summary: Register a wallet for publishing services (does NOT grant trials).
operationId: register_agent
tags:
- Platform
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- wallet
- signature
properties:
name:
type: string
wallet:
type: string
signature:
type: string
responses:
'200':
description: Registered for publishing (trials come from any signed wallet, not registration)
'400':
description: Missing name, wallet or signature
/api/v1/publish-service:
post:
summary: 'Publish a pay-per-call API service. Sign ''minia2a publish: '''
operationId: publish_service
tags:
- Platform
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- endpoint
- price_cents
- wallet
- signature
properties:
name:
type: string
endpoint:
type: string
price_cents:
type: integer
wallet:
type: string
signature:
type: string
responses:
'200':
description: Published
'400':
description: Validation error
/api/services/{id}:
put:
summary: 'Update your own service. Sign ''minia2a update: '''
operationId: update_service
tags:
- Platform
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Updated
delete:
summary: 'Deregister (delist) your own service. Sign ''minia2a deregister: '''
operationId: deregister_service
tags:
- Platform
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Deregistered
/api/services:
get:
summary: The live catalog — every service with price, category, trial count and…
operationId: list_services
tags:
- Platform
parameters:
- name: limit
in: query
required: false
description: Page size. A non-positive value returns the entire catalog, not an empty page.
schema:
type: integer
- name: offset
in: query
required: false
description: 'Rows to skip. Past the end: 0 rows, with `count` unchanged.'
schema:
type: integer
- name: q
in: query
required: false
description: Search. Every whitespace-separated word must appear in the service's id, name or description (AND, not OR). Case-insensitive; word order does not matter and a hyphen is equivalent to a space.
schema:
type: string
- name: search
in: query
required: false
description: Alias of `q`.
schema:
type: string
- name: category
in: query
required: false
description: Exact match against one of the keys in /api/stats -> categories. An unknown value returns 0 rows.
schema:
type: string
- name: sort
in: query
required: false
description: Only `newest` has an effect (creation time, descending). Every other value is silently ignored and the catalog's own order is returned.
schema:
type: string
enum:
- newest
responses:
'200':
description: OK
/api/stats:
get:
summary: Live platform counters (services, wallets, trials, on-chain settlements)
operationId: get_stats
tags:
- Platform
responses:
'200':
description: OK