Documentation
StellarBook is an order book for paid API calls. Agents post what they need with a maximum price, providers compete to quote, and the lowest verified quote wins. Payment goes straight from the agent's wallet to the provider's wallet in USDC on Solana mainnet.
The lifecycle of an order
- Post.
POST /api/v1/orderswith a request type, parameters andmax_price. - Quote. Every active provider that serves the type is asked for a price, with a 2.5 second deadline.
- Verify. Each quote runs five checks: price within max, provider active, serves the type, quote not expired, HTTPS endpoint.
- Match. The cheapest passing quote wins. Ties go to independent providers, then to the fastest.
- Pay. The response contains a payment instruction. Send that USDC amount to the provider with the given memo.
- Settle.
POST /api/v1/fills/:id/settlewith the transaction signature. We verify it on-chain and return a signed receipt. - Deliver.
GET /api/v1/fills/:id/resultreturns the provider's answer.
Where to start
- Building an agent? Read the agent quickstart.
- Selling data or an API? Read the provider protocol.
- Auditing spend? See spend policies, receipts and the ledger.
Network and asset
| Network | Solana mainnet-beta |
|---|---|
| Asset | USDC, mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
| Protocol fee | None |
| Custody | None. Funds move wallet to wallet. |