Market

Get Gemstone By Id

Get complete details of a specific gemstone by its ID.

Returns comprehensive gemstone market data including:

  • Basic information (variety, source, characteristics)
  • Value drivers (carat, color, clarity, cut - with descriptions and star ratings)
  • Market dynamics (supply, demand, trends)
  • Market insights (up to 6 key facts)
  • 2025 pricing details (min, avg, max, percentiles, YoY change) + computed UI fields (e.g., $K formats, YoY calc)
  • Historical pricing (2020-2025 with event notes + $K for graph)
  • Metadata (created_at, updated_at timestamps)

All UI computations (e.g., $K formatting, YoY %, graph-ready data) are done backend-only to reduce client load. No variety-based queries; ID-only for security/scalability.

Args: gemstone_id: Unique integer ID of the gemstone record

Returns: GemstoneMarketDetailResponse: Complete gemstone details with pre-computed UI data

Raises: HTTPException 404: If gemstone with given ID is not found HTTPException 500: If database error occurs

get/api/v1/market/data/{gemstone_id}

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/data/{gemstone_id}
  • Auth: none declared

Path parameters

gemstone_idinteger required

Response

Successful Response

idinteger required
varietystring required
primary_sourcestring nullable
characteristicsstring nullable
image_urlstring nullable
value_driversobject

Value drivers for carat, color, clarity, and cut

market_insightsstring[]

List of market insight facts

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.