Data Model & Usage
A reference for the NFT Portal data model and how assets flow through the Revenue Rail.
NFTAsset Entity
Every NFT in the ecosystem is a single NFTAsset record. All portal pages read from and write to this entity — there is no separate public API.
| Field | Type | Description |
|---|---|---|
| name | string | NFT name (required) |
| description | string | Optional description |
| image_url | string | Cover image URL |
| site_id | string | Originating ecosystem site |
| tier | enum | Prediction · Sample · Full Card · Limited · Group Pack · Archive |
| chain | enum | Solana · Ethereum · Polygon |
| mint_price | number | Mint price (USD) |
| status | enum | pending · minted · listed · sold |
| minted_at | datetime | When the NFT was minted |
| tx_hash | string | On-chain transaction hash |
| sale_price | number | Sale price (USD) |
| sold_at | datetime | When the NFT sold |
| appraisal_status | enum | pending · certified |
| appraisal_value | string | Certified appraisal range |
Revenue Rail Flow
- 1Receive & Source
- 2Appraise & Certify
- 3Mint & Make Available
- 4Distribute Across Sites
- 5Collect Revenue
- 6Report & Reinvest
Usage
- Dashboard — counts and revenue computed live from NFTAsset.
- Mint — creates a real NFTAsset record with status minted.
- Marketplace — shows records where status is listed.
- Reports — shows records where appraisal_status is certified.
- Revenue — aggregates sale_price over sold_at.
- Sites — NFT counts grouped by site_id.
There is no public REST API. All data access is through the portal's entity layer.
