Quickstart

Two paths. Pick yours.

I want to BUY (call a paid endpoint)

No account. You need a wallet with USDC on the endpoint’s network.

1. Find one: GET /discover.json → pick a relay URL (/r/{provider}/{endpoint}).
2. Get the price: request it with no payment → HTTP 402 with accepts (price, network, asset, payTo = splitter).
3. Pay: build an X-PAYMENT header — sign EIP-3009 (Base) or a Soroban auth entry (Stellar) binding the exact amount/nonce. (Reference implementations: scripts/live_settle_base_mainnet.py, scripts/live_settle_stellar_testnet.py.)
4. Retry with the header → you get the result + an X-PAYMENT-RECEIPT.

Full details: Buy a call.

I want to SELL (publish an endpoint)

1. Authenticate — easiest is Connect in Claude (OAuth login). Headless? Use a wallet signature → automation key.
2. Create an API relay or MCP wrapper — MCP tool create_api_relay / create_mcp_wrapper, or POST /dashboard/endpoints/{api,mcp}:

   {"name":"Weather","slug":"weather","origin_url":"https://api.me.com/v1/weather",
    "method":"GET","price_usd":"0.02","networks":["eip155:8453"],"pay_to":"0xYourWallet"}
   

3. Publish — publish_endpoint / POST /dashboard/endpoints/{id}/publish.
4. Test — hit your /r/{provider}/weather with no payment; you should see your 402. Pay it once to confirm end-to-end.

Then manage it (edit price/origin, pause, delete) any time, from Claude or the API.

Conventions you’ll hit

• USDC decimals: 6 on Base and Solana, 7 on Stellar.
• Network ids: eip155:8453 (Base mainnet), stellar:pubnet, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (Solana mainnet).
• Live now: mainnet only (Base + Stellar pubnet + Solana).
• Endpoint lifecycle: create → draft; publish → active; pause → disabled; delete → soft-deleted (slug freed).

More background: Concepts.