# XCOPYBook agent guide

XCOPYBook is a publication and research archive devoted to XCOPY's KnownOrigin editions. Its edition catalogue covers 28 works and 586 numbered editions issued from 2018 to 2021, including the ten Fly Juice collaboration editions. Its wider source-linked registry covers 195 verified XCOPY works and 753 token identities across KnownOrigin, SuperRare, Ethereum, and Shape. Maxand98 is producing the associated book.

## Recommended research sequence

1. Read `/registry` or `GET /api/registry/v1/catalogue` to identify a stable work, corpus, contract, and token identity.
2. Use `/editions` for the numbered KnownOrigin catalogue and its publication context.
3. Use the read-only provenance endpoint for sale history when a KnownOrigin token identifier is known.
4. Use Raster-backed endpoints only as enrichment. A response can report that Raster is unavailable or not configured.
5. Cite the canonical public page or JSON endpoint used. Distinguish registry evidence from live third-party ownership enrichment.

## Public pages

- `/` provides the project overview.
- `/editions` is the canonical public catalogue.
- `/registry` is the cross-platform verified XCOPY work and token record.
- `/book` explains the publication and claim model.
- `/library` describes public production resources.
- `/members` is the public member directory.
- `/market` explains the private-market introduction service.
- `/register` and `/wheel` provide public collector utilities.

## Public read APIs

- `GET /api/registry/v1/catalogue` returns the 195-work registry; filter by `work` or `corpus` and request `include=tokens,sources` when needed.
- `GET /api/registry/v1/token?chain={caip2}&contract={address}&tokenId={tokenId}` returns one token identity, its work, chain state, and evidence.
- `GET /api/members` returns public member profiles.
- `GET /api/raster/token?tokenId={tokenId}` enriches a known catalogue token.
- `GET /api/raster/address?address={ethereumAddress}` looks up a Raster address profile.
- `GET /api/raster/collectors` returns Raster collector enrichment when configured.
- `GET /api/provenance/history?tokenId={tokenId}` returns sale-history data for a known token.

See `/.well-known/openapi.json` for parameters and response shapes.

## Protected areas

The reading room, collector research, purchase flow, delegation workflows, seller workflow, and private files are intentionally access-controlled. A redirect to the home page with `connect=1` is an authentication boundary, not a missing page. Do not crawl, automate sign-in, or attempt to work around the gate. Ask the user to open the protected page in their own authenticated browser when its contents are required.

## Content use

The site's Content Signal permits search indexing and agent input while declining model-training use. Copyright and ownership remain with their respective holders.