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

# Market

The Market Discovery page serves as the real-time aggregation engine and decentralized trading terminal for the OURS platform (`ours.meme`). Natively deployed on the open, EVM-compatible Robinhood Chain (Chain ID: 4663), the terminal provides traders, alpha hunters, and quantitative bots with sub-second visibility across both internal Bonding Curve pools (Phase 0) and graduated Uniswap v4 deep liquidity pools (Phase 2).

The terminal natively supports community tokens paired against liquid crypto assets (ETH, USDC) as well as 190+ verified Robinhood Stock and ETF Tokens (such as NVDA, TSLA, AAPL, and SPY).

### 1. Top Ecosystem Dashboard (Macro Metrics)

The top summary ribbon synchronizes directly with Robinhood Chain RPC indexers and contract states, delivering real-time macro protocol health:

* 24h Volume: Cumulative 24-hour trading volume aggregated across all active bonding curves and graduated Uniswap v4 pools (denominated in USD equivalent).
* Daily Launches: Total number of new community tokens deployed within the current 24-hour UTC cycle.
* Graduated Pools: Cumulative count of tokens that have achieved 100% bonding curve capacity and migrated permanently into Uniswap v4 deep liquidity pools.
* Stock Assets Supported (190+): Total number of verified tokenized equities and benchmark ETFs available via the Robinhood Chain Asset Registry that can be paired directly with community tokens.
* Quick Access Navigation:
  * `+ Launch Token`: Immediate routing to the non-custodial token deployment console.
  * `$OURS Token →`: Dedicated dashboard tracking $OURS circulating metrics, 12-month per-second linear vesting streams, and automated flywheel execution proofs.

### 2. Market Navigation & Real-Time Filtering Tools

The discovery engine indexes token states dynamically to support scouts, momentum traders, and systematic indexers:

#### Category Views

* 🔥 Trending: Algorithmic ranking calculated from real-time turnover velocity, short-term buy-side volume acceleration, and liquidity depth.
* ⚡ New: Strict chronological feed ordered by block timestamp, surfacing newly deployed Phase 0 curve assets.
* 🎯 Graduating Soon: Filters tokens currently at 60% – 99% curve completion, highlighting immediate breakout candidates nearing liquidity migration to Uniswap v4.
* 🦄 Graduated: Phase 2 assets actively trading in Uniswap v4 pools with continuous creator fee sharing, permanent protocol-locked liquidity, and eligible platform buyback streams.

#### Smart Search & Filtering

* Instant Multivariable Search: Query in real time by Token Name, Ticker Symbol (e.g., `$PEPNVDA`), Quote Asset (`NVDA`, `ETH`, `SPY`), or contract address.
* Quote Currency Filter: Isolate tokens paired strictly against specific equity classes (Tech Equities, Index ETFs, Meme Equities, or Crypto-Native pairs).

### 3. Token Card Metrics & Visual Interface

Every project listed across the terminal is rendered as an interactive, live-updating component displaying critical on-chain metrics:

| **Metric Card Field** | **Protocol Specification**                                                                                                                         | **Data Source / Standard**                                               |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| Asset & Pair          | Token Name, Symbol, and Quote Asset (e.g., `$PEPNVDA` / `NVDA`)                                                                                    | Read from `LaunchFactory` and `AssetRegistry`.                           |
| 24h Price Change      | Percentage price delta along the curve or v4 pool                                                                                                  | Computed against rolling 1,440-minute USD prices.                        |
| Market Capitalization | Real-time valuation: $$ $\text{Current Price} \times 1,000,000,000$ $$                                                                             | Fixed 1B supply standard; denominated in USD.                            |
| Trading Volume        | Net cumulative turnover of confirmed swaps                                                                                                         | Aggregated swap volume excluding failed transactions.                    |
| Graduation Status     | <p>Phase 0 (0%–99%): Live progress bar toward target quote reserve.</p><p><br></p><p>Phase 2 (100%): Verified Uniswap v4 Badge with pool link.</p> | Monitored directly via contract reserve storage and Uniswap v4 Pool IDs. |

### 4. Full Lifecycle & Flywheel Pipeline

Every asset discovered on the Market terminal follows an automated, unalterable four-stage economic pipeline:

Plaintext

```
+-----------------------------+     +-----------------------------+
| 01 Launch on Robinhood Chain| ==> | 02 Bonding Curve Trading    |
| 1B fixed supply, zero       |     | Sub-second swaps, minOut    |
| team pre-allocation         |     | slippage & stock pairings   |
+-----------------------------+     +-----------------------------+
               |                                   |
               v                                   v
+-----------------------------+     +-----------------------------+
| 03 Graduate to Uniswap v4   | ==> | 04 OURS Transparent Flywheel|
| Protocol-custodied / locked |     | Continuous 70% Creator Fee  |
| liquidity migration         |     | & 48/16/16/20 Platform Vault|
+-----------------------------+     +-----------------------------+
```

#### Stage 01: Fair Launch (100% to Public Curve)

* Deployed via `LaunchFactory` on Robinhood Chain (`4663`) with a standardized 1,000,000,000 (1B) supply.
* Zero team pre-allocations, zero advisor pools, zero private discounts. 100% of supply is injected into the bonding curve at block zero.

#### Stage 02: Phase 0 Bonding Curve Swaps

* Algorithmic price discovery paired against native ETH, USDC, or 190+ Robinhood Stock Tokens.
* Programmatic `minOut` slippage verification protects traders from front-running and MEV sandwich bots.
* Every swap accumulates verified turnover toward $OURS Behavior Mining allocations.

#### Stage 03: Automated Uniswap v4 Graduation

* Reaching 100% bonding curve capacity programmatically triggers migration.
* Accumulated quote reserves and remaining tokens are swept into a Uniswap v4 deep liquidity pool.
* LP positions are permanently custodied and locked by protocol contracts—eliminating manual migration delays, liquidity extraction, and rug pulls.

#### Stage 04: The 48 / 16 / 16 / 20 Platform Flywheel

Trading across both Phase 0 curves and Phase 2 Uniswap v4 pools enforces the platform's 1.00% base swap fee structure:

* 70% Creator Fee Share: Disbursed directly to project teams to fund continuous development, internal curve buyback & burns, or stock asset dividends.
* 30% Platform Fee Share (0.30% Gross Turnover): Executed autonomously on-chain via `OursFlywheelVault`:
  * 🔥 48% $OURS Buyback & Burn: Continuous secondary market repurchases and irreversible token destruction.
  * 💰 16% $OURS Holder Dividend Pool: Distributed to holders via a dynamic holding streak formula ($$W\_i = B\_i + \Delta(D\_i)$$). Holders receive a 1.2x streak acceleration for the first 14 days; any balance reduction resets the streak counter back to Day 1.
  * 🚀 16% Graduated Meme Buyback & Burn: Programmatically deployed into secondary markets to market-buy and destroy graduated Phase 2 tokens trading on Uniswap v4, eliminating post-graduation liquidity cliffs.
  * ⚙️ 20% Security, Development & Operations: Streamed to a public multi-sig treasury for smart contract security audits, node operations, and ongoing engineering.

### 5. Zero-Trust Verification & Terminal Architecture

* Zero-Trust On-Chain State: All market caps, candle points, and graduation progress displayed on the interface are derived from verified contract events and RPC state queries—completely eliminating spoofed off-chain volume.
* One-Click Execution: Selecting any token card routes directly into the interactive execution terminal featuring sub-second swap execution, interactive TradingView charts, and live creator fee distribution telemetry.
* Developer SDK Access: All market discovery parameters are accessible programmatically for trading bots and aggregators via `@ours-platform/launchpad-sdk`:

  TypeScript

  ```
  import { MarketClient } from '@ours-platform/launchpad-sdk';
  const market = new MarketClient({ baseUrl: 'https://dev-oursmeme-api.openhub.network/api' });

  // Query trending or graduated tokens programmatically
  const tokens = await market.listTokens({ page: 1, pageSize: 20, type: 'graduated' });
  ```