---
title: "Get Market Overview"
method: GET
path: "/api/v1/market/v2/overview"
tags: ["Market V2"]
---

# Get Market Overview

`GET /api/v1/market/v2/overview`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/market/v2/overview`
- Auth: none declared

GET /api/v1/market/v2/overview
Personalized markets homepage: daily pulse (null until first generation),
metal prices, your_market (owned varieties by est value desc), watchlist,
1d movers, and news with owned/watched varieties boosted to the top.
Anonymous callers without X-Device-Id get the generic payload.

## Headers

- `X-Device-Id` integer, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- MarketOverviewResponse
  - `as_of` string, nullable
  - `pulse` PulseBlock
    - `headline` string, required
    - `body` string, required
    - `generated_at` string, date-time, required
  - `metal_prices` MetalPrices
    - `gold` number, nullable
    - `silver` number, nullable
    - `platinum` number, nullable
    - `gold_change_7d_pct` number, nullable
    - `silver_change_7d_pct` number, nullable
    - `platinum_change_7d_pct` number, nullable
  - `your_market` VarietyCard[]
    - `variety` string, required
    - `index_value` number, required
    - `change_1d_pct` number, nullable
    - `change_7d_pct` number, nullable
    - `change_30d_pct` number, nullable
    - `confidence_tier` string
    - `explanation_headline` string, nullable
    - `sparkline_7d` number[]
    - `owned_count` integer, nullable
    - `owned_est_value` number, nullable
    - `is_watched` boolean
    - `image_url` string, nullable
    - `tier` string
  - `watchlist` VarietyCard[]
    - `variety` string, required
    - `index_value` number, required
    - `change_1d_pct` number, nullable
    - `change_7d_pct` number, nullable
    - `change_30d_pct` number, nullable
    - `confidence_tier` string
    - `explanation_headline` string, nullable
    - `sparkline_7d` number[]
    - `owned_count` integer, nullable
    - `owned_est_value` number, nullable
    - `is_watched` boolean
    - `image_url` string, nullable
    - `tier` string
  - `movers` AppSchemasMarketV2MoversBlock
    - `gainers` VarietyCard[]
      - `variety` string, required
      - `index_value` number, required
      - `change_1d_pct` number, nullable
      - `change_7d_pct` number, nullable
      - `change_30d_pct` number, nullable
      - `confidence_tier` string
      - `explanation_headline` string, nullable
      - `sparkline_7d` number[]
      - `owned_count` integer, nullable
      - `owned_est_value` number, nullable
      - `is_watched` boolean
      - `image_url` string, nullable
      - `tier` string
    - `losers` VarietyCard[]
      - `variety` string, required
      - `index_value` number, required
      - `change_1d_pct` number, nullable
      - `change_7d_pct` number, nullable
      - `change_30d_pct` number, nullable
      - `confidence_tier` string
      - `explanation_headline` string, nullable
      - `sparkline_7d` number[]
      - `owned_count` integer, nullable
      - `owned_est_value` number, nullable
      - `is_watched` boolean
      - `image_url` string, nullable
      - `tier` string
  - `news` NewsItemV2[]
    - `id` integer, required
    - `title` string, required
    - `url` string, nullable
    - `source_name` string, required
    - `published_at` string, date-time, required
    - `category` string, nullable
    - `sentiment_score` number, nullable
    - `impact_direction` string, nullable
    - `estimated_price_impact_pct` number, nullable
    - `user_facing_summary` string, nullable
    - `affected_species` string[], nullable
    - `affected_families` string[], nullable
    - `affected_countries` string[], nullable
    - `event_type` string, nullable
    - `severity` integer, nullable
    - `image_url` string, nullable
    - `ai_generated` boolean
    - `is_family_level` boolean
    - `outlet_count` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)