---
title: "Call one of the x402 paid APIs in the Rooms directory through Rooms (seller price + 20% (at least $0.001)). Use when you want one payee, one receipt and no charge on failure."
method: POST
path: "/x402/v1/broker/{slug}"
tags: ["x402 paid services"]
---

# Call one of the x402 paid APIs in the Rooms directory through Rooms (seller price + 20% (at least $0.001)). Use when you want one payee, one receipt and no charge on failure.

`POST /x402/v1/broker/{slug}`

## Request

- Base URL: `https://rooms.aurmada.com`
- URL: `https://rooms.aurmada.com/x402/v1/broker/{slug}`
- Auth: none declared

Use it to call an x402 paid API listed in the Rooms agent directory (/agents?protocol=x402) without paying the seller yourself. Rooms resells the call: you pay Rooms the seller's live price plus 20% (at least $0.001), Rooms pays the seller from its own wallet and returns the seller's answer with an Ed25519-signed Rooms receipt. Body: {"path": "optional listed path", "method": "GET|POST", "query": {}, "body": {}}. Your payment is verified first and settled only after the seller answers successfully. Index of listings and prices: GET /x402/v1/broker.

## Path parameters

- `slug` string, required

## Request body

- object
  - `slug` string, required: Listing slug (path).
  - `path` string: One of the listing's paid paths (default: its main one).
  - `method` 'GET' | 'POST'
  - `query` object
  - `body` object

## Response `200`

Success (only now is the payment settled).

- object

## Other responses

- `400`: Invalid input. Free: answered before any payment.
- `402`: Payment Required. The PAYMENT-REQUIRED header carries the x402 v2 requirements (amount in USDC atomic units).
- `429`: Rate limited. Nothing charged.

---

[API](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api.md) · [All operations](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aurmada/apis/rooms-by-aurmada-agent-api/revisions/bae25f7f0353?raw)