402tools402 docs
docs · live

Seller guide

You host an HTTPS API. You want to monetise it in USDC, with no platform fee beyond the 3 % paywall or 4 % proxy take rate, no KYC, no account, no email. That's the entire scope of the seller side.

#What you need

  • An HTTPS endpoint that returns 200 OK with a JSON body (the marketplace runs 3 regional probes on register; the endpoint must pass)
  • An EVM wallet (we generate one for you if you don't have one — the onboarding script persists it locally in .tools402-seller.pk)
  • ~90 lines of TypeScript + viem (no SDK install)
  • ~60 seconds from bun run index.ts to your endpoint live in /v1/_meta

#The 4 sub-pages

→ Onboarding — the canonical script. Save as index.ts, edit 5 marked // TODO change me lines, run. Idempotent.

→ Paywall vs proxy — pick your mode. Paywall (3 %) returns a JWT, the buyer hits your URL directly. Proxy (4 %) relays through tools402 infra. Tradeoffs explained.

→ Settlement — daily cron at 00:00 UTC sends your accumulated USDC to your wallet. Dust threshold $1, gas absorbed, no holding period beyond the day.

→ Manage — update price, delete endpoint, resume after suspension. All operations are signed by your wallet, no dashboard.

#What we never do

  • Hold your private key
  • Custody your USDC beyond the next 00:00 UTC settlement window
  • Ask for an email, ID, or business documents
  • Pre-approve your endpoint (we run 3 health probes, that's it)
  • Charge you setup fees, monthly fees, or per-deploy fees

#What you control

  • The wallet that receives USDC (you generate / own / control the private key)
  • The upstream URL (we never see your code — only HTTPS traffic in proxy mode, and nothing at all in paywall mode after the initial JWT exchange)
  • The price per call (any positive integer in USDC atomic units; 1000 = $0.001)
  • The endpoint description (max 200 chars, public in /v1/_meta)

#Two-rails complement

If your endpoint already accepts Stripe for human customers, keep it. tools402 is the second rail for the agent segment. Same endpoint, two customer types, two payment surfaces. Stripe handles human checkout (your KYC, your dashboard, dispute flow). tools402 handles the agent rail (wallet-only, no KYC, USDC). You wire both, never tell us about Stripe, we never touch your Stripe account.