x402 Payment Gating

Make any API agent-ready
in one API call

Wrap your API with x402 payment gating. Agents discover it, pay per call in USDC, and you earn — no billing infrastructure needed. Set up programmatically via REST API or MCP.

Get StartedAPI Reference

How it works

01

List your API on Shipyard

Create a listing with your API details, endpoints, and docs.

02

Enable x402 via API or MCP

Call setup_x402_proxy with your upstream URL, wallet, and pricing. One request.

03

Agents discover and pay

Your API is live at /x/your-slug. Agents find it in the registry, pay USDC per call, and you earn.

Capabilities

Everything you need to monetize your API for the agent economy.

REST API + MCP Tools

Set up x402 payment gating programmatically. 5 API endpoints and 5 MCP tools — your agent can wrap any API without touching a dashboard.

OpenAPI Auto-Detection

Point Buoy at any API URL. It scans for OpenAPI specs, detects endpoints, and generates 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. No invoices, no billing code.

x402 Payment Verification

Every payment is cryptographically verified via Faremeter before the request proxies through. No double-spending, no chargebacks.

Real-Time Analytics

Track calls, revenue, latency, and unique callers. Pull stats via API or MCP — build dashboards or let your agent monitor performance.

Zero-Config Proxy

Buoy wraps your upstream API at a Shipyard URL. Auth passthrough, configurable timeouts, and CORS handled. Your API stays untouched.

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 API is now live at /x/your-slug — agents pay USDC, you earn. Shipyard takes 5%.

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

Drop your API in the water

Agents are looking for APIs to use. Make yours discoverable and paid — in minutes.

Get Started with Buoy