x402 pay-per-call

Turn any API into a paid endpoint
agents can call

Point Buoy at one upstream URL. It finds endpoints, sets a price, and publishes a proxy agents can call. Your API stays unchanged, and you collect per-call payments in USDC.

Set up Buoy See API setup

How it works

Choose the API

Pick the listing you want to monetize and give Buoy its upstream URL.

Scan and set pricing

Buoy tries to detect OpenAPI endpoints, then you set a default price and payout wallet.

Share the proxy URL

Agents call /x/your-slug, Buoy checks payment, and the request reaches your API.

Capabilities

Everything you need to turn an API into a paid, agent-ready service.

REST API + MCP

Set up x402 payment gating programmatically. One flow for the API and MCP layers, no dashboard required.

OpenAPI Auto-Detection

Point Buoy at any API URL. It scans for OpenAPI specs, detects endpoints, and prepares pricing configs automatically.

USDC Per-Call Payments

Agents pay in USDC on Solana for every API call. You set the price, connect your wallet, and earn instantly.

x402 Payment Verification

Every payment is cryptographically verified via Faremeter before the request proxies through.

Real-Time Analytics

Track calls, revenue, latency, and unique callers. Pull stats via API or MCP.

Zero-Config Proxy

Buoy wraps your upstream API at a Shipyard URL. Auth passthrough, timeouts, and CORS are handled for you.

API Reference

All endpoints require Bearer authentication with an sk_live_* API key.

REST API

POST

/api/v1/x402/setup

Create proxy config, wallet, and pricing

GET

/api/v1/x402/{listingId}

View config and endpoint pricing

PUT

/api/v1/x402/{listingId}/pricing

Update endpoint pricing

GET

/api/v1/x402/{listingId}/stats

Analytics and transaction history

POST

/api/v1/x402/scan

Auto-detect endpoints from OpenAPI

MCP Tools

Connect via the Shipyard MCP server. Works with Claude, Cursor, and any MCP-compatible agent.

setup_x402_proxy

Full setup in one call

get_x402_config

View current configuration

update_x402_pricing

Modify endpoint pricing

scan_api_endpoints

OpenAPI auto-detection

get_x402_stats

Pull analytics and transactions

One request to go live

Terminal

curl -X POST https://openshipyard.xyz/api/v1/x402/setup \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "listing_id": "your-listing-uuid",
    "upstream_base_url": "https://api.yourservice.com",
    "wallet_address": "your-solana-wallet",
    "default_price_usdc": 0.01
  }'

Your proxy URL is the public address agents use: /x/your-slug Buoy handles payment and forwarding behind that URL.

Pair with Shipwright

After wrapping your API with Buoy, generate a CLI + MCP server automatically. Agents get payment gating AND native tooling.

Learn about Shipwright

Publish your proxy URL

Agents are looking for APIs to call. Buoy makes yours discoverable, paid, and ready in minutes.

Set up Buoy

Turn any API into a paid endpointagents can call