> For the complete documentation index, see [llms.txt](https://raretyperesearch.gitbook.io/stockmon/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://raretyperesearch.gitbook.io/stockmon/markets.md).

# Markets

**Markets** is Stockmon’s read-only view of the Genesis 116 Vault. It answers a precise question: what does each token ID’s exact onchain ledger contain, and what is that ledger worth under a clearly timestamped price snapshot?

{% hint style="info" %}
Markets and Marketplace are different. **Markets** reads balances and estimates. **Marketplace** is the separate noncustodial listing and purchase experience for Genesis NFTs.
{% endhint %}

## What Markets shows

Every Genesis row is built from the token ID’s actual Vault subledger:

| Field               | Evidence             | Meaning                                                                            |
| ------------------- | -------------------- | ---------------------------------------------------------------------------------- |
| Stock Token amount  | Exact onchain atoms  | Settled token entitlement recorded for that Genesis ID                             |
| Pending WETH        | Exact onchain atoms  | WETH reserved for a lineage but not yet converted into verified Stock Token output |
| Funded WETH         | Exact ledger math    | Settled cost plus pending WETH—the capital basis Markets compares against          |
| USD mark            | Timestamped estimate | Exact balances multiplied by validated external or oracle prices                   |
| Mark vs WETH budget | Derived estimate     | Change between the complete USD mark and the same funded WETH budget               |
| Price coverage      | Validation state     | Complete, partial, stale, or unavailable—not a cosmetic confidence score           |

An exact balance can remain visible when price evidence fails. The USD mark cannot.

## How one Stockmon is marked

For every DNA lineage in the token’s Vault ledger, Markets combines:

```
settled Stock Token atoms × validated stock price
+ pending WETH atoms × validated ETH/USD price
= timestamped component estimate
```

The component estimates add up to the Stockmon’s displayed Vault mark. The Genesis-wide mark adds the complete token-level estimates across all 116 IDs.

This calculation never substitutes the creature’s original DNA weights for missing holdings. DNA decides allocation; the exact ledger proves the result.

## The 16 Genesis market lineages

Genesis Feed accounting uses one fixed ordered set of 16 lineages:

|      |      |                       |      |
| ---- | ---- | --------------------- | ---- |
| NVDA | TSLA | GOOGL                 | AAPL |
| MSFT | AMZN | META                  | PLTR |
| SPY  | QQQ  | SPACEX (`SPCX` token) | BA   |
| RIVN | IREN | RGTI                  | QBTS |

The lineage label is part of Stock DNA. The Stock Token contract is a separate identity. The app checks that contract before any swap.

## Exact, estimated, and unavailable

Markets deliberately uses three truth levels:

### Exact ledger

The release reads all 116 token-level subledgers and all 16 assets from a pinned Robinhood Chain block. Provider consensus, block identity, and ledger reconciliation are required.

### Timestamped USD estimate

A USD mark is display-only. It is eligible only when the complete required price set passes source, time, address, status, and freshness checks. Every estimate carries an observation time and validity window.

### Unavailable

If current price evidence is incomplete, stale, halted, or unverifiable, the current USD mark is hidden. A clearly labeled last verified **aggregate** may be shown during an outage, but it never backfills current per-token prices or rewrites exact balances.

{% hint style="warning" %}
The displayed USD mark is not a redemption quote, sale offer, guaranteed floor, brokerage balance, or promise of liquidity. Exact contract atoms and confirmed ownership are authoritative; the mark is an estimate at a stated time.
{% endhint %}

## What the Markets screen helps you inspect

* the exact WETH funded and still pending across Genesis;
* complete, partial, or unavailable price coverage;
* a searchable ranking of Genesis token IDs when a current complete mark exists;
* each Stockmon’s settled Stock Token and pending WETH components;
* the source status and observation time behind each price; and
* verified history windows only when a real indexed series exists.

Unavailable history controls remain disabled. Stockmon does not draw a fictional chart to fill an empty time range.

## Markets versus other Stockmon systems

| System      | Primary job                                                | Does it move value?                         |
| ----------- | ---------------------------------------------------------- | ------------------------------------------- |
| Markets     | Read exact Vault ledgers and timestamped display estimates | No                                          |
| Marketplace | Discover, sign, cancel, and settle Genesis NFT orders      | Yes, when Marketplace is enabled in the app |
| Feed        | Allocate received stock-budget WETH by living ID and DNA   | Yes, when a Feed round settles              |
| Hunt        | Coming-soon active-play position                           | No                                          |
| PVP         | Coming-soon creature-versus-creature competition           | No                                          |

## Data and market risks

Stock Tokens, ETH, WETH, NFTs, and `$MON` can change in value. U.S. equity session state, halts, stale feeds, sequencer safety, issuer restrictions, RPC disagreement, and route availability can all affect what can be displayed or executed.

Markets keeps exact evidence, hides unsupported estimates, and never turns missing data into a confident number.

Next: [The NFT lifecycle](/stockmon/nft-lifecycle.md), then [Marketplace and Den](/stockmon/nft-lifecycle/marketplace-and-den.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://raretyperesearch.gitbook.io/stockmon/markets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
