Skip to main content
You already have a working service. This page puts a price tag on one endpoint, gets it listed in the Bazaar, and confirms the first paid request goes through. If you spend more than an hour on this, something in these docs has failed, not you.

Prerequisites

  • An existing HTTP server (Express, FastAPI, Next.js, Hono, or similar)
  • A Stellar account address to receive payments (payTo)
  • Testnet USDC is not required. You receive payments, you do not send them

1. Install the middleware

2. Price a route

The describe block is what the Bazaar catalogs. Skip it and your endpoint still gets paid, but nobody will find it.

3. Confirm the listing

Your endpoint should appear in the response within a few seconds of the first 402 it serves. See Verifying Your Listing for what to check if it does not.

4. Watch it get paid

Point a buyer at your URL, or run the buyer quickstart against it. On a successful request you will see the payment tx hash in the X-Payment-Response header, and settlement lands in your Stellar account in around 5 seconds.

Where to go next

Declaring Discovery Metadata

What to put in describe so agents can actually find your endpoint.

Choosing a Pricing Scheme

When to use exact versus upto for metered workloads.

Verifying Your Listing

Debug why an endpoint is missing from search, or ranked lower than expected.

Going to Mainnet

Everything to check before flipping the network flag.