> ## Documentation Index > Fetch the complete documentation index at: https://docs.8bitedge.com/llms.txt > Use this file to discover all available pages before exploring further. # Demand & Intent — Game endpoints reference > Game demand leaderboards, individual game profiles, trending titles, watched games, and per-game condition breakdowns. Scope: demand-intent.read. The game demand endpoints let you see which retro game titles buyers are actively seeking — measured by purchase-intent clicks (redirects to eBay listings), watchlist alerts, and search activity. Use them to answer questions like "what should I stock right now?", "is interest in this title accelerating?", and "should I sell this copy loose or complete in box?". All endpoints documented on this page require the `demand-intent.read` scope and a valid `Authorization: Bearer ` header. ## Common query parameters All list endpoints on this page share the following query parameters. The time window to aggregate over. One of `day`, `7d`, or `30d`. Restrict results to games belonging to this console. Omit to return results across all consoles. Override the target date. Defaults to the latest computed date for the selected period. Format: `YYYY-MM-DD`. Page size. Capped by your plan's `max_page_size`. Page number (page-mode pagination). Cursor token for cursor-mode pagination. Pass `paginate=cursor` to opt in. Pagination mode. Set to `cursor` to use cursor-based pagination. ## Derived fields Several fields in the response are computed from the raw demand data rather than stored directly. Understanding how they are derived helps you interpret what they signal. ### `momentum` ``` momentum = (redirects_7d / 7) ÷ (redirects_30d / 30) ``` Momentum measures whether buyer interest is accelerating or fading by comparing the recent 7-day daily pace against the longer 30-day baseline. A value above 1.0 means the game is getting more attention recently than its baseline average. | Label | Condition | | --------- | --------------------- | | `rising` | momentum 1.2 or above | | `steady` | between 0.8 and 1.2 | | `cooling` | below 0.8 | When a game has no 30-day baseline (it is newly tracked, or had no activity in the prior 30 days), both `value` and `label` are returned as `null` / `"unknown"`. ### `demand_score` A single 0–100 index blending intent, reach, and watch demand into one comparable number. Each component is normalised against the highest value in the current period and console scope, so the top-ranked title always scores 100 and every other title is scored relative to it. The three signals blended are: * **Intent** — redirect volume (purchase-intent clicks). * **Reach** — distinct users who generated those clicks. * **Watch demand** — watchlist alert count. ### `mobile_share` The fraction of demand activity that originated from a mobile device, expressed as a value between `0.0` (no mobile activity) and `1.0` (all mobile). Useful for understanding your buyers' browsing context. *** ## GET /api/v1/demand-intent/games Returns a ranked leaderboard of games by demand for the selected period. Use this endpoint to answer "what should I source and stock right now?" ```bash theme={null} curl -s "https://api.8bitedge.com/api/v1/demand-intent/games" \ -H "Authorization: Bearer $TOKEN" | jq ``` ### Query parameters In addition to the [common parameters](#common-query-parameters): Sort order for the leaderboard. One of: * `intent` — by redirect volume (default) * `watches` — by `watch_count` descending (latent demand) * `momentum` — by the momentum ratio descending (fastest-rising first) ### Response Returns a paginated array of leaderboard rows. The `meta` object includes the resolved `period`, `period_date`, and `sort`. Array of leaderboard rows, each representing one game ranked by the selected sort. The game's rank within the current period and sort. Precomputed from the demand metrics tables. Game identity fields. Unique game ID. Display name of the game. URL slug for the game. ID of the console this game belongs to. Display name of the console. Purchase-intent signals derived from redirect clicks to eBay listings. Number of purchase-intent clicks in the period. Number of unique users who clicked through. Fraction of clicks from mobile devices (0.0–1.0). Watchlist / notification alert signals (latent demand). Number of active watchlist alerts for this game in the period. Acceleration of interest relative to the 30-day baseline. Computed ratio. `null` when no 30-day baseline exists. `rising`, `steady`, `cooling`, or `unknown`. Current market prices from the catalog. Loose (cartridge/disc only) price as a decimal string. Complete-in-box price as a decimal string. Sealed/new price as a decimal string. Composite 0–100 demand index. The highest-ranked title in the result set always scores 100. The resolved period (`day`, `7d`, or `30d`). The date the data was computed for (YYYY-MM-DD). The active sort (`intent`, `watches`, or `momentum`). Standard pagination metadata (see [Pagination](/concepts/pagination)). **Example response:** ```json theme={null} { "data": [ { "rank": 1, "game": { "id": 412, "name": "Chrono Trigger", "slug": "chrono-trigger", "console_id": 19, "console_name": "Nintendo SNES" }, "intent": { "redirects": 980, "distinct_users": 712, "mobile_share": 0.41 }, "watch": { "watch_count": 64 }, "momentum": { "value": 1.4, "label": "rising" }, "pricing": { "loose": "40.00", "complete": "95.50", "new": "300.00" }, "demand_score": 100 } ], "meta": { "period": "7d", "period_date": "2026-06-16", "sort": "intent", "pagination": { "mode": "page", "page": 1, "per_page": 25, "total": 842, "last_page": 34 } }, "links": { "next": "https://api.8bitedge.com/api/v1/demand-intent/games?page=2", "prev": null } } ``` *** ## GET /api/v1/demand-intent/games/{game_id} Returns a full demand profile for one game, with metrics shown side-by-side for all three periods (`day`, `7d`, and `30d`). Use this to understand how a specific title is performing across different time horizons. ```bash theme={null} curl -s "https://api.8bitedge.com/api/v1/demand-intent/games/412" \ -H "Authorization: Bearer $TOKEN" | jq ``` ### Path parameters The numeric ID of the game. You can resolve IDs from the [Games catalog endpoints](/api/games). ### Response Game ID. Display name. Display name of the console. Current market prices. Loose price (decimal string). Complete-in-box price (decimal string). Sealed/new price (decimal string). Demand metrics for each time window. Purchase-intent clicks in the last day. Unique users in the last day. Active watchlist alerts in the last day. Leaderboard rank for the day period. Purchase-intent clicks in the last 7 days. Unique users in the last 7 days. Active watchlist alerts in the last 7 days. Leaderboard rank for the 7-day period. Purchase-intent clicks in the last 30 days. Unique users in the last 30 days. Active watchlist alerts in the last 30 days. Leaderboard rank for the 30-day period. Momentum ratio (7-day pace vs. 30-day baseline). `null` if no baseline. `rising`, `steady`, `cooling`, or `unknown`. **Example response:** ```json theme={null} { "data": { "game": { "id": 412, "name": "Chrono Trigger", "console_name": "Nintendo SNES" }, "pricing": { "loose": "40.00", "complete": "95.50", "new": "300.00" }, "periods": { "day": { "redirects": 140, "distinct_users": 121, "watch_count": 9, "rank": 2 }, "7d": { "redirects": 980, "distinct_users": 712, "watch_count": 64, "rank": 1 }, "30d": { "redirects": 3120, "distinct_users": 2380, "watch_count": 210, "rank": 1 } }, "momentum": { "value": 1.4, "label": "rising" } } } ``` Returns `404 not_found` if the `game_id` does not correspond to an enabled game in the catalog. *** ## GET /api/v1/demand-intent/games/{game_id}/conditions Returns a condition breakdown for one game, showing whether buyers most want it **loose** (cartridge/disc only), **CIB** (complete in box), **new** (sealed), or **any** (no condition preference). This is sourced from saved notification alerts — real buyer intent with a specific condition attached — making it a reliable signal for how to list your copy. ```bash theme={null} curl -s "https://api.8bitedge.com/api/v1/demand-intent/games/412/conditions?period=7d" \ -H "Authorization: Bearer $TOKEN" | jq ``` ### Path parameters The numeric ID of the game. ### Query parameters The time window to aggregate over. One of `day`, `7d`, or `30d`. ### Response Game ID. Display name. URL slug. Console ID. Console display name. Loose price (decimal string). Complete-in-box price (decimal string). Sealed/new price (decimal string). All four condition rows, sorted by rank. Rows sum to approximately 1.0 on `condition_share`. Rank within this game's conditions for the period. One of `loose`, `cib`, `new`, or `any`. Number of active watchlist alerts for this game/condition pair. Number of price-drop notification triggers for this game/condition pair. This condition's share of all alerts across the game's four conditions (0.0–1.0). All four rows sum to \~1.0. Unique users behind these alerts. Fraction of alert activity from mobile devices (0.0–1.0). All four conditions are always returned. A condition with no alerts in the selected period appears as a zeroed row (`watch_count: 0`, `condition_share: 0.0`) ranked after the conditions that had activity. Returns `404 not_found` if the `game_id` is unknown or disabled. *** ## GET /api/v1/demand-intent/trending Returns games ranked by momentum — the fastest-rising titles whose recent daily activity most exceeds their 30-day baseline. Use this to get ahead of demand before prices move. The sort is fixed to `momentum` and cannot be overridden. ```bash theme={null} curl -s "https://api.8bitedge.com/api/v1/demand-intent/trending?period=7d" \ -H "Authorization: Bearer $TOKEN" | jq ``` ### Query parameters The time window to aggregate over. One of `day`, `7d`, or `30d`. Filter results to a single console. Override the target date (defaults to latest computed). Page size. Page number. Cursor token for cursor-mode pagination. Set to `cursor` for cursor-based pagination. ### Response Returns a paginated array of leaderboard rows in the same shape as `GET /api/v1/demand-intent/games`. The `meta.sort` field is always `"momentum"`. Games with no 30-day baseline are excluded from this endpoint — momentum is undefined without a prior period to compare against. If you need to include brand-new titles, use the main leaderboard with `sort=intent`. *** ## GET /api/v1/demand-intent/watched Returns the most-watched games — titles with the highest number of active watchlist alerts, representing buyers who are waiting for the right price before purchasing. This surfaces latent demand that redirect intent alone may not capture: a game with modest click-through but many alert saves signals a price-sensitive buyer pool ready to act. ```bash theme={null} curl -s "https://api.8bitedge.com/api/v1/demand-intent/watched?period=7d" \ -H "Authorization: Bearer $TOKEN" | jq ``` ### Query parameters The time window to aggregate over. One of `day`, `7d`, or `30d`. Filter results to a single console. Override the target date (defaults to latest computed). Page size. Page number. Cursor token for cursor-mode pagination. Set to `cursor` for cursor-based pagination. ### Response Returns a paginated array of leaderboard rows in the same shape as `GET /api/v1/demand-intent/games`. The sort is fixed to `watch_count` descending. Redirect intent (`intent.redirects`) is left-joined from the intent table and may be `0` for titles that have watchlist saves but no purchase-intent clicks in the period. Because this endpoint is built from the watch table rather than the intent table, you may see titles that do not appear on the main leaderboard at all — games people are waiting on but not yet actively clicking to buy.