Loading
PRICE DISCUSSION DOCS
APP
Updated 2026-10-11·View as Markdown

Building on PD

Price Discussion wants a tool ecosystem it didn't build. The platform's own surfaces are opinionated readings of the market — but the underlying data belongs to the chain and the community, and the best trackers, dashboards, bots, and analysis tools will come from collectors who wanted something PD doesn't do. Build them. This page is the map of what's open.

The chain surface — open today, permissionless forever

Everything tokenized lives on Ethereum, readable by anyone, with no key, no rate limit PD controls, and no permission to ask:

  • Authenticity — one call answers whether any contract is a real PD Project: PDFactory.isProject(address). See the verification pattern.
  • Ownership & provenance — standard ERC-721 Transfer events give every Output's full custody chain; PDProject.totalSupply() and tokenHashes(id) give mint state and each Output's generative seed (zero until the Output is revealed, a block after its mint — watch Revealed(tokenId, tokenHash)).
  • The art itself — tokenURI returns the complete, self-contained artwork; getScript() hands you the raw generative script, decoded from the base64 it is stored as. For a big script, read it chunk by chunk with scriptChunk(i) for each of its scriptChunkCount() chunks and join them in order. You can re-render any Output from chain data alone — that's the whole design.
  • Live activity — Minted and ProjectCreated events are the platform's real-time pulse; every indexer trick that works on Ethereum works on PD.
  • Money mechanics — royalty splits, pending balances, and every payout are readable on the Project and splitter contracts.
  • The sticker economy — sheets, print runs, sealed supply, and pool state are all public reads on PDStickers; sealedOutstanding alone is a market-data feed waiting for a chart.

A weekend's work gets you a mint bot, a floor tracker, a provenance checker, a portfolio dashboard, or a renderer — with no dependency on PD's servers at all.

The API surface — real, growing into its public reference

PriceOS runs on its own HTTP API: public reads for projects, outputs, users, and social state, with writes authenticated by Sign-In With Ethereum. It is the source of truth for everything the chain doesn't hold — @names, follows, stars, albums, and the social layer around the art.

The API reference is being published into these docs section by section as endpoints stabilize toward launch. Until an endpoint appears here, treat it as unstable — the chain surface above is the durable foundation to build on first.

Agents are first-class

Every page of this documentation is machine-readable by design: /llms.txt is the index, /llms-full.txt is the whole site in one fetch, and any page's URL + .md returns raw markdown. If you're building with an AI agent — or building an agent — start it there; the docs were engineered to be its context.

House rules

Three, all obvious:

  1. Don't impersonate PD. Name your tool as yours; verification patterns exist so nobody has to trust a lookalike.
  2. Respect the chain's economics. Tools that honor EIP-2981 keep artists paid; tools that route around it are venue-side choices PD's contracts can't stop, but the community notices.
  3. Ship it. The platform's thesis is that the community's reading of the market is the product — community tools are that thesis, running.

Further reading