Skip to content
demob.Marketplace

For developers

Retrieve reference editions with x402.

Discover published metadata for free, then pay test USDC on Base Sepolia for one exact JSON reference edition.

Testnet API

https://demob-payments.rincodemaintainer.workers.dev

The API is deployed. Paid listings become available after a contributor registers a wallet, the factory deployment is configured, and an operator publishes a reviewed edition. Existing catalog records are illustrative. MCP tools remain a future integration.

Callable REST endpoints

All payment and receipt responses are private and never cached.

GET /api/listings

Free discovery

Published listing IDs, edition, scope, integer USDC amount and availability.

GET /api/listings/:id

Free metadata

Exact publication terms. Paid reference payload is omitted.

GET /api/listings/:id/retrieve

x402 paid retrieval

HTTP 402 quote; signed requests settle payment and return the JSON edition.

POST /api/contributors

Wallet ownership proof

Links the registered payout wallet and approved splitter to a contributor account.

Quote, sign, retrieve

  1. Request a published listing’s retrieval endpoint. Read the x402 v2 body or PAYMENT-REQUIRED header.
  2. Use an x402 client to sign the exact requirement with your buyer wallet. The recipient is the contributor’s verified splitter.
  3. Send PAYMENT-SIGNATURE to the quoted resource URL. Generic x402 clients may retry the original URL with the returned quote metadata.
  4. Receive the edition only after settlement succeeds. Save PAYMENT-RESPONSE and the original signed request.
  5. Retry the same signed request to recover delivery without another charge. If settlement is uncertain, keep that authorization until it is reconciled.

Quotes last five minutes. Testnet terms use eip155:84532 and Circle’s six-decimal USDC. The fixed split is 97% contributor and 3% marketplace. This version delivers JSON reference editions.

Open the sample checkout