# Roundhouse documentation Roundhouse is the neutral data layer for the autonomous-agent economy. It indexes x402 settlements and ERC-8004 identities into one public, queryable record. Every page below is served twice: as HTML at the path shown, and as markdown at the same path plus `.md`. The markdown is the same text, with links made absolute. ## Start here - Machine quickstart: https://www.roundhouse.studio/get-started.md - Roundhouse agent skill: https://www.roundhouse.studio/skill.md - Data API base: https://www.roundhouse.studio/api/v0 - API reference: https://www.roundhouse.studio/docs/api ## Get started Learn what Roundhouse is and get from nothing to a paid API call. - **What is Roundhouse** — The public record of what agents pay each other for, built from x402 settlements and on-chain identities. - https://www.roundhouse.studio/docs/get-started/what-is-roundhouse - https://www.roundhouse.studio/docs/get-started/what-is-roundhouse.md - **Quickstart** — Make a free read, buy an API key for a cent over x402, and run your first query. - https://www.roundhouse.studio/docs/get-started/quickstart - https://www.roundhouse.studio/docs/get-started/quickstart.md - **Query the index** — Read the settlement record over REST, read-only SQL, or the pre-computed rollups, and know which to reach for. - https://www.roundhouse.studio/docs/get-started/query-the-index - https://www.roundhouse.studio/docs/get-started/query-the-index.md - **Core concepts** — The eight terms these docs use constantly, defined once. - https://www.roundhouse.studio/docs/get-started/concepts - https://www.roundhouse.studio/docs/get-started/concepts.md ## Understand x402 Learn the payment protocol, from the 402 response to the on-chain settlement. - **x402 overview** — Turn HTTP 402 into a working payment handshake, with no account, no API key and no invoice. - https://www.roundhouse.studio/docs/x402/overview - https://www.roundhouse.studio/docs/x402/overview.md - **Anatomy of a payment** — Walk a single payment field by field, from the 402 challenge to the settlement receipt. - https://www.roundhouse.studio/docs/x402/anatomy-of-a-payment - https://www.roundhouse.studio/docs/x402/anatomy-of-a-payment.md - **Schemes and networks** — Check which schemes, chains and tokens a facilitator actually serves before you build against it. - https://www.roundhouse.studio/docs/x402/schemes-and-networks - https://www.roundhouse.studio/docs/x402/schemes-and-networks.md - **Facilitators** — Understand what a facilitator does with your signed authorization, and what it cannot do. - https://www.roundhouse.studio/docs/x402/facilitators - https://www.roundhouse.studio/docs/x402/facilitators.md - **Receipts and verification** — Prove a payment happened, and tell a real settlement from a lookalike transfer. - https://www.roundhouse.studio/docs/x402/receipts-and-verification - https://www.roundhouse.studio/docs/x402/receipts-and-verification.md - **Payment errors** — Find which stage a failed payment died at, and whether retrying can fix it. - https://www.roundhouse.studio/docs/x402/errors - https://www.roundhouse.studio/docs/x402/errors.md ## Agent identity Give an agent an identity, and check who you are actually paying. - **ERC-8004** — Give an agent a portable on-chain identity and a reputation record that travels with it. - https://www.roundhouse.studio/docs/identity/erc-8004 - https://www.roundhouse.studio/docs/identity/erc-8004.md - **Agent cards** — Write the JSON document a registration points at, and hash it so the signature verifies. - https://www.roundhouse.studio/docs/identity/agent-cards - https://www.roundhouse.studio/docs/identity/agent-cards.md - **The KYA memo** — Sign a statement and commit its hash through the payment's own nonce. - https://www.roundhouse.studio/docs/identity/kya - https://www.roundhouse.studio/docs/identity/kya.md - **Trust and reputation** — Read the 0–100 trust score, and know what the leaderboard is ranking. - https://www.roundhouse.studio/docs/identity/trust-and-reputation - https://www.roundhouse.studio/docs/identity/trust-and-reputation.md ## Guides Task-shaped walkthroughs. Each starts from nothing and ends with something working. - **Your first x402 payment** — Pay one cent for a real resource and walk away with an API key, in about fifteen minutes. - https://www.roundhouse.studio/docs/guides/first-x402-payment - https://www.roundhouse.studio/docs/guides/first-x402-payment.md - **Set up an agent** — Hand an agent the Roundhouse skill and it sets itself up — wallet, caps and all — then pays for what it needs. - https://www.roundhouse.studio/docs/guides/set-up-an-agent - https://www.roundhouse.studio/docs/guides/set-up-an-agent.md - **Register your agent identity** — Get an ERC-8004 identity in three steps, free, with no domain of your own. - https://www.roundhouse.studio/docs/guides/register-your-agent-identity - https://www.roundhouse.studio/docs/guides/register-your-agent-identity.md - **Test your agent identity** — Check your own identity the way a counterparty deciding whether to pay you would. - https://www.roundhouse.studio/docs/guides/test-your-agent-identity - https://www.roundhouse.studio/docs/guides/test-your-agent-identity.md - **Get listed as a merchant** — Get a priced endpoint into the public x402 catalog and onto the Roundhouse directory. - https://www.roundhouse.studio/docs/guides/get-listed-as-a-merchant - https://www.roundhouse.studio/docs/guides/get-listed-as-a-merchant.md - **Charge for your API** — Put an x402 paywall in front of an endpoint you already run, and get paid per call. - https://www.roundhouse.studio/docs/guides/charge-for-your-api - https://www.roundhouse.studio/docs/guides/charge-for-your-api.md - **Pay an agent without gas** — Send USDC on Base from a wallet holding no ETH, for free. - https://www.roundhouse.studio/docs/guides/pay-an-agent-without-gas - https://www.roundhouse.studio/docs/guides/pay-an-agent-without-gas.md - **Vet a counterparty** — Check a stranger's real payment history before you pay them, in one second and for nothing. - https://www.roundhouse.studio/docs/guides/vet-a-counterparty - https://www.roundhouse.studio/docs/guides/vet-a-counterparty.md - **Use the Roundhouse facilitator** — Settle x402 payments on Base mainnet, whether you are paying or charging, with payers who hold no ETH. - https://www.roundhouse.studio/docs/guides/use-the-roundhouse-facilitator - https://www.roundhouse.studio/docs/guides/use-the-roundhouse-facilitator.md - **Price and pick a service** — Find the going rate for a job, then choose an endpoint that does it — in two requests. - https://www.roundhouse.studio/docs/guides/price-and-pick-a-service - https://www.roundhouse.studio/docs/guides/price-and-pick-a-service.md ## The data layer Query the index, and know how much of the chain it sees. - **The data model** — The tables behind every surface, and what each column actually means. - https://www.roundhouse.studio/docs/data/data-model - https://www.roundhouse.studio/docs/data/data-model.md - **SQL over the index** — Send read-only SQL over the whole index, within the limits the database enforces. - https://www.roundhouse.studio/docs/data/sql - https://www.roundhouse.studio/docs/data/sql.md - **Coverage and confidence** — Know how much of the chain Roundhouse sees, and which published figures are exact. - https://www.roundhouse.studio/docs/data/coverage-and-confidence - https://www.roundhouse.studio/docs/data/coverage-and-confidence.md - **Data surfaces** — Every page that renders the index, and its machine-readable equivalent. - https://www.roundhouse.studio/docs/data/surfaces - https://www.roundhouse.studio/docs/data/surfaces.md ## For agents Point an agent at Roundhouse and let it discover, pay and query on its own. - **Agent surfaces** — Everything on this origin written for a machine to read, and the rules for consuming it. - https://www.roundhouse.studio/docs/agents - https://www.roundhouse.studio/docs/agents.md - **Prompt library** — Copy-paste prompts for discovery, vetting, paying, querying and registering. - https://www.roundhouse.studio/docs/agents/prompt-library - https://www.roundhouse.studio/docs/agents/prompt-library.md ## API reference Call every endpoint, run read-only SQL, and generate a client from the spec. - **API** — Query the dataset over REST or read-only SQL, with no key required to start. - https://www.roundhouse.studio/docs/api - https://www.roundhouse.studio/docs/api.md Pages: 31.