# api.forsale

The sell rail. One typed Deal state machine — 7 stages (sourced, qualified,
meeting, proposal, negotiation, closed_won, closed_lost) and 3 marketplace
Roles (setter, closer, nurturer) — where executors (agent or human) propose
and the deal gate alone commits. Escalation routes a stage to a verified human
closer under the Seller's Mandate; the caller just sees the deal advance.

## Doors on this origin

- `GET /deals` — the keyless branching collection: filter by `stage` or
  `role`; a non-matching filter answers a typed 200 EMPTY; reserved scopes
  (`tenant`, `settlement`) answer a typed 403 BLOCKED. All records are
  labeled synthetic sandbox data (demo tenant).
- `GET /deals/{id}` — one Deal with its labeled example fields.
- `GET /gigs` — role-scoped marketplace gigs; filter by `role` or `status`.
- `GET /offer` — the 402 OFFER boundary, served as a LABELED STUB: it shows
  the shape of the coming rate card (pay / work / claim alternatives) and
  nothing is billable today.
- `POST /mcp` — the MCP door (streamable HTTP): tools `listDeals`,
  `getDeal`, `listGigs` over the same collections.
- `GET /verify` — run our tests: the public-contract probe suite, runnable
  by anyone with curl.

## Live product environment

The interactive kernel demo (create deals, advance them, escalate to human
gigs) runs at https://demo.api.forsale/ — one process, both services, seeded
with example data and resettable via POST /demo/reset.

## Machine surfaces

- Capability card (AXP probe manifest): https://api.forsale/.well-known/agents.json
- OpenAPI 3.1 contract: https://api.forsale/openapi.json
- Pricing Document: https://api.forsale/pricing
- icp.json (agent classes): https://api.forsale/icp.json
- Documentation: https://api.forsale/docs
- Family registry (sibling doors as typed edges): https://api.forsale/family.json
- This file: https://api.forsale/llms.txt
- Conformance (independent verifier): https://api.qa/api.forsale

## The family

- demo.api.forsale — live kernel demo — create, advance, escalate and settle deals against seeded example data: https://demo.api.forsale/
- closers.sale — human-vocabulary supply door — the B2C high-ticket closer pool (no API vocabulary): https://closers.sale/
- closers.deals — human-vocabulary supply door — the B2B closer pool (no API vocabulary): https://closers.deals/