POST
/
v2
/
market
/
brands
/
rolex
/
official-vs-market
Compare official Rolex list prices with market averages
curl --request POST \
  --url https://api-v2.watchcollect.com/v2/market/brands/rolex/official-vs-market \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "brand": "<string>",
  "total": 123,
  "items": [
    {
      "brand": "<string>",
      "official": {
        "reference": "<string>",
        "reference_normalized": "<string>",
        "status": "available",
        "configuration_count": 123,
        "collection": "<string>",
        "model": "<string>",
        "market_reference": "<string>",
        "official_url": "<string>",
        "official_image_url": "<string>",
        "price": {
          "amount_minor": 123,
          "currency": "<string>"
        },
        "locale": "<string>",
        "scraped_at_ms": 123,
        "configuration_key": "<string>",
        "configuration_label": "<string>",
        "dial": "<string>",
        "bezel": "<string>",
        "bracelet": "<string>"
      },
      "market_listing_count": 123,
      "row_id": "<string>",
      "market_average": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "market_profit_amount": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "market_profit_percent": 123,
      "sample_media_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sample_media_url": "<string>",
      "applied_mapping_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "effective_filter": {}
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
references
object[]

Optional official references to return. If omitted, the endpoint returns the first official rows for the brand.

Maximum array length: 200
view_id
string<uuid> | null

Saved view filters are combined with calculator filters and per-reference brand/reference filters.

filters
object

Flexible market filter grammar. Documented fields are typed; additional fields are tolerated for forward-compatible frontend experiments and ignored until implemented.

sort
enum<string>
default:profit_desc
Available options:
profit_desc,
profit_asc,
uplift_desc,
uplift_asc,
profit-desc,
profit-asc,
uplift-desc,
uplift-asc
display_currency
string
Required string length: 3
Example:

"EUR"

exclude_outliers
boolean
default:true
page_size
integer
default:200
Required range: 1 <= x <= 200

Response

Official Rolex prices joined with market aggregates.

brand
string
required
total
integer
required
items
object[]
required