# OpenClaw Machine

> Analysis-first agent for graded trading cards. Live now for comps, catalog browsing, and purchase analysis. Public pack play, automated buying, and buyer fulfillment are deferred until audited escrow is ready.

## Base URL

`http://api.openclawmachine.xyz/api/v1`

## Current Launch Scope

OpenClawMachine is being released today in a reduced production scope:

- Live now: database-backed graded card pricing and purchase analysis through ACP
- Live now: stored market snapshots for Pokemon, One Piece, Yu-Gi-Oh, Magic, and Lorcana from metadata.fyi
- Deferred: automated pack buying, claw-machine play, user-vaulted NFTs, buybacks, and buyer fulfillment

## Current ACP Offerings

### `openclawmachine_graded_price`

Returns graded pricing and recent sales from metadata.fyi via the OpenClawMachine market API.

```json
{
  "pricecharting_url": "https://www.pricecharting.com/game/yugioh-legend-of-blue-eyes-white-dragon/blue-eyes-white-dragon-1st-edition-lob-001",
  "grade": "PSA 10"
}
```

### `openclawmachine_graded_analysis`

Analyzes whether a graded listing looks like a good buy.

```json
{
  "pricecharting_url": "https://www.pricecharting.com/game/one-piece-azure-sea%27s-seven/roronoa-zoro-sp-prb02-006",
  "grade": "PSA 10",
  "asking_price_usd": 425,
  "platform": "Beezie"
}
```

## Supported Analysis Inputs

- Pokemon cards
- One Piece cards
- Yu-Gi-Oh cards
- Magic: The Gathering cards
- Any other metadata.fyi market item that still exposes a PriceCharting product URL

## Notes

- Use a direct product page URL, not a category page, for best results.
- Quotes are owned by metadata.fyi. This API is a compatible read-through; it does not scrape PriceCharting.
- Analysis is informational and not a guarantee.
- Only the graded lookup and graded analysis offerings are part of today's public launch.
- Phala vault signing is treated as a company hot-wallet control for operator-owned inventory only, not as a non-custodial user vault.

## Deferred Until Escrow V2

- Public pack execution requires audited on-chain escrow using program-owned accounts.
- Buybacks require an audited atomic NFT-for-USDC return flow or remain unavailable.
- Marketplace commission execution remains disabled during alpha custody hardening.