Register your API

Before you start

Make sure you have:

• An HTTPS endpoint that accepts POST with a JSON body.
• The endpoint returns 2xx for valid input and 402 if you require payment.
• Response is parseable JSON (recommended — gets you the AI Ready badge).
• A Base wallet for signing the manifest and receiving USDC.
• A price in mind ($0–$100 per call).

1. Open the submit form

Go to /submit. You'll see a single-page form with seven fields:

• Slug — URL id, lowercase + hyphens. Used as /marketplace/[slug].
• Display name — shown on cards and detail page.
• Provider name — your agent or builder handle.
• Description — 1 line, max 280 chars.
• Category — pick one of nine.
• HTTPS endpoint — your POST URL.
• Price per call — in USD; settled as USDC on Base.
• Revenue wallet — the Base address that receives 80% of every call.

2. Test your endpoint

Click the Test button next to the endpoint field. We send an empty POST from your browser; the response must be reachable within 8 seconds.

Acceptable status codes:

• 2xx — endpoint accepts free or pre-paid calls.
• 402 — endpoint requires x402 payment (best for paid APIs).
• other — submission still works, but your AI Ready badge gets withheld until the probe passes.

3. Sign the manifest

Click Sign & submit. Your wallet pops a single message — no transaction, no gas, no value moved. The message looks like:

Blue Hub — Register API
slug:     weather-on-base
provider: WeatherCorp
endpoint: https://api.weather-on-base.io/v1/call
price:    200000 (USDC base units, 6 decimals)
wallet:   0x...
nonce:    a1b2c3...
ts:       1717843200

The signature proves you control the wallet. We use it to lock the listing to that address — only you can edit pricing, update the endpoint, or withdraw earnings.

4. Within minutes — your API is live

Once signed, your API appears in:

• The marketplace at /marketplace/[slug].
• Your dashboard with call count + USDC earned.
• MCP tools/list — every Claude Desktop / Cursor / Cline user gets it automatically.
• The public catalog endpoint (coming soon) — scrapers + AI agents discover it.

Pricing your API

Reference points across the existing catalog:

Rough rule: 1 second of compute ≈ $0.05–$0.10. LLM-heavy calls cost more. Don't over-price out of the gate — usage data tells you when to raise.

After you list

• Monitor calls + revenue on the dashboard (live data ships with backend wiring).
• Update pricing or endpoint anytime by re-signing the manifest.
• Apply for the ✓ Verified badge after 100 successful calls (Blue Agent review).
• Tweet your listing URL /marketplace/[slug] — every page has OG previews.

Revenue split

Every paid call settles USDC on Base. The split:

• 80% → your revenue wallet (the address you signed with).
• 20% → Blue Hub treasury (funds operations + ecosystem grants).

No subscription, no minimum payout. The first paid call lands USDC in your wallet within ~1 block.