---
title: "Variety Listings"
method: GET
path: "/api/v1/markets/{variety}/listings"
tags: ["Markets"]
---

# Variety Listings

`GET /api/v1/markets/{variety}/listings`

## 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/markets/{variety}/listings`
- Auth: none declared

GET /api/v1/markets/{variety}/listings?limit=5
Recent price observations for an index-tracked variety, newest first.
404 when the variety isn't in price_index_daily. Items carry
{title, price, carat, source, observed_at} — no URLs in v1.

## Path parameters

- `variety` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- VarietyListingsResponse
  - `variety` string, required
  - `items` VarietyListingItem[], required
    - `title` string, required
    - `price` number, required
    - `carat` number, nullable
    - `source` string, required
    - `observed_at` string, required

## 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)