brand_list
ChatGPTList brands Access: Level 1 endpoint, available to every Professional membership. Retrieve the list of brands supported by the WatchCharts API. Parameters: - min_watch_count (number(integer), optional): Only returns brands with at least this number of supported watches with market data. Defaults to 1. Response: - name (string): Name of the brand - uuid (string): Unique identifier of the brand - watch_count (integer): The number of supported watches with market data in the brand - has_index (boolean): Whether or not the brand has a market index - collections (array<string>):
refresh_access
ChatGPTRe-check which WatchCharts tools this account can call right now, based on its current plan and endpoint permissions. Call this after the account's plan or endpoint permissions change, or when a tool said it is not available on the current plan. Changes apply immediately in this conversation: every tool stays listed, and the API decides at call time. Tools added since the conversation started are named here; they can be used in a new conversation.
search_watch
ChatGPTSearch for a watch Access: Level 1 endpoint, available to every Professional membership. Search for a watch in our catalog based on the brand and reference number. A list of results with the watch uuid will be returned, which will be used to query the "/watch/" endpoints. Parameters: - brand_name (string, required): The name of the brand to search within. For a list of supported brand names, refer to the "/brand/list" endpoint. - reference (string, required): The reference number to search for. - exact_match (boolean, optional): By default, this endpoint returns partial matches. If exact_match is set to true, only watches and variants that exactly match the reference number provided will be returned. Defaults to false. - include_no_data (boolean, optional): By default, this endpoint only returns watches and variants that have a computed market_price. If include_no_data is set to true, watches and variants that do not have a market price will also be included in the results. This is useful if you would like to retrieve the median_asking_price from the "/watch/info" endpoint. Defaults to false. Response: - success (boolean): Whether or not the brand_name provided matched a brand in our database - results (array<string>): The result(s), if any, which matched the provided reference number within the given brand
watch_appraisal
ChatGPTGet watch appraisal Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Make an appraisal for a watch based on condition, delivery contents, and region. Parameters: - uuid (string, required): The uuid of the watch to retrieve. - condition (new | used, required): The condition of the watch. - delivery_contents (watch_only | watch_with_box_and_papers, required): The delivery contents of the watch. - region (g | na | eu | as, required): The region the watch is located in. Use g for Global, na for North America, eu for Europe, and as for Asia. - type (market | dealer, optional): Whether to retrieve the dealer or market price. - date (string(date), optional): The date of the market price to retrieve, in YYYY-MM-DD format. If no date is provided, the latest date with market data is used. Only the market price fields (market_price, dealer_price, volatility) move with the date; figures that have no history, such as the median asking price and sales volume, are always reported as of the latest data. - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices. Response: - success (boolean): Whether or not the the specified watch is supported for appraisal - brand (string): The brand of the requested watch - collection (string): The collection of the requested watch - model (string): The model (reference number) of the requested watch - date (string(date)): The date of the price and volatility retrieved, or null if the specified watch is not supported for appraisal - price (number(integer)): The market price at the specified date, or null if no market data was available at that date - volatility (number(float)): The volatility at the specified date, or null if no market data was available at that date
watch_info
ChatGPTGet watch info Access: Level 1 endpoint, available to every Professional membership. Retrieve basic information about a watch, including the brand, collection, reference number, and market price. market_price is the default market price. The default series is the appraisal for a used watch, with box and papers, in the global region, at the market (private party) price — identical to supplying condition=used, delivery_contents=watch_with_box_and_papers, region=g, type=market. dealer_price is the same appraisal at the dealer price instead (type=dealer). For a market price on a different basis — a new watch, watch only, or a specific region — use the "/watch/appraisal" endpoint. Passing a date changes only market_price, dealer_price and volatility, which are looked up for that day. median_asking_price, median_asking_price_count and sales_volume_1y have no history and are always the current figures. Parameters: - uuid (string, required): The uuid of the watch to retrieve. - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices. - date (string(date), optional): The date of the market price to retrieve, in YYYY-MM-DD format. If no date is provided, the latest date with market data is used. Only the market price fields (market_price, dealer_price, volatility) move with the date; figures that have no history, such as the median asking price and sales volume, are always reported as of the latest data. Response: - brand (string): The brand of the requested watch - collection (string): The collection of the requested watch - model (string): The model (reference number) of the requested watch - market_price (number(float)): The market price (private party value) of the requested watch - dealer_price (number(float)): The dealer price of the requested watch - volatility (number(float)): The market volatility of the requested watch - median_asking_price (number(float)): The median asking price of the requested watch across the last 30 days of listings in our database, always as of the latest data regardless of the "date" parameter; null if there were no listings - median_asking_price_count (integer): The number of listings used to calculate the median asking price, always as of the latest data regardless of the "date" parameter - sales_volume_1y (integer): The number of sales recorded for the requested watch across the last 12 months, always as of the latest data regardless of the "date" parameter - updated (string(date)): The date the market price fields are as of — the requested "date" when one is given, otherwise the date the watch market data was last updated
watch_listings
ChatGPTGet watch listings Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Retrieve the 10 most recent listings for this watch from private sales sources. Parameters: - uuid (string, required): The uuid of the watch to retrieve. Response: - title (string): - seller_name (string): The name the seller listed under. null where the source does not attribute the listing. - thumbnail_url (string(uri)): An image from the listing, preferring one showing the watch on its own. null where the listing has no images. - price_in_usd (number(float)): - price_in_requested_currency (number(float)): - url (string(uri)): - created (string(date)):
watch_price_1y
ChatGPTGet watch 1 year price history Access: Level 1 endpoint, available to every Professional membership. Retrieve the daily price history for a watch over the past year. This endpoint always returns the default market price history. The default series is the appraisal for a used watch, with box and papers, in the global region, at the market (private party) price — identical to supplying condition=used, delivery_contents=watch_with_box_and_papers, region=g, type=market. The appraisal parameters accepted by "/watch/price_5y" and "/watch/price_full" are not configurable here — appraisal price history is a Level 2 feature — and supplying them does not change the series returned. Parameters: - uuid (string, required): The uuid of the watch to retrieve. - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices.
watch_price_5y
ChatGPTGet watch 5 year price history Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Retrieves the daily price history for a watch over the last 5 years. By default this returns the market price history. The default series is the appraisal for a used watch, with box and papers, in the global region, at the market (private party) price — identical to supplying condition=used, delivery_contents=watch_with_box_and_papers, region=g, type=market. To retrieve a different appraisal price history — the equivalent of the "/watch/appraisal" endpoint over the full period — supply condition, delivery_contents and region (and optionally type). These parameters must be supplied together: an incomplete set returns a 400 rather than falling back to the default series. Every response reports the basis of the price history it returned through the Wc-Appraisal-Condition, Wc-Appraisal-Delivery-Contents, Wc-Appraisal-Region and Wc-Appraisal-Type headers, using the same values as the corresponding query parameters. They are always present, so which market price you received never has to be inferred. Where an appraisal price history is not available for a watch, the default market price history is returned and the headers report its basis. Parameters: - uuid (string, required): uuid of the watch - condition (new | used, optional): The condition of the watch. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to used. - delivery_contents (watch_only | watch_with_box_and_papers, optional): The delivery contents of the watch. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to watch_with_box_and_papers. - region (g | na | eu | as, optional): The region the watch is located in. Use g for Global, na for North America, eu for Europe, and as for Asia. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to g. - type (market | dealer, optional): Whether to retrieve the dealer or market price. Only applies when requesting an appraisal price history; defaults to market, which is also the basis of the default series. - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices.
watch_price_full
ChatGPTGet watch full price history Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Retrieves the complete daily price history for a watch. By default this returns the market price history. The default series is the appraisal for a used watch, with box and papers, in the global region, at the market (private party) price — identical to supplying condition=used, delivery_contents=watch_with_box_and_papers, region=g, type=market. To retrieve a different appraisal price history — the equivalent of the "/watch/appraisal" endpoint over the full period — supply condition, delivery_contents and region (and optionally type). These parameters must be supplied together: an incomplete set returns a 400 rather than falling back to the default series. Every response reports the basis of the price history it returned through the Wc-Appraisal-Condition, Wc-Appraisal-Delivery-Contents, Wc-Appraisal-Region and Wc-Appraisal-Type headers, using the same values as the corresponding query parameters. They are always present, so which market price you received never has to be inferred. Where an appraisal price history is not available for a watch, the default market price history is returned and the headers report its basis. Parameters: - uuid (string, required): uuid of the watch - condition (new | used, optional): The condition of the watch. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to used. - delivery_contents (watch_only | watch_with_box_and_papers, optional): The delivery contents of the watch. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to watch_with_box_and_papers. - region (g | na | eu | as, optional): The region the watch is located in. Use g for Global, na for North America, eu for Europe, and as for Asia. Required when requesting an appraisal price history. Omitting the appraisal parameters entirely returns the default series, which corresponds to g. - type (market | dealer, optional): Whether to retrieve the dealer or market price. Only applies when requesting an appraisal price history; defaults to market, which is also the basis of the default series. - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices.
watch_retail
ChatGPTGet watch retail price Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Retrieves the retail price information for a watch based on the given currency. Parameters: - uuid (string, required): uuid of the watch - currency (USD | EUR | GBP | AUD | CHF | CAD | HKD | JPY | SGD | CNY | INR | MXN | DKK | AED | SEK | TWD | ZAR | NZD | SAR, optional): The currency to use when retrieving prices. Response: - value (number): The retail price in the requested currency. An estimate converted from another currency where no price was published in this one. - value_updated (string(date)): The month the retail price was recorded. - in_production (boolean): Whether this is a price you could still pay in this currency: the watch is in production and the price was published in the requested currency rather than converted into it. The same field /watch/retail_history reports. - in_production_updated (string(date)): When production status was last confirmed. null when in_production is false.
watch_specs
ChatGPTGet watch specs Access: Level 2 endpoint. On an account without Level 2 access, calling it returns a not-available message instead of data; use refresh_access to see what this account can call now. Retrieve model specifications for a watch. Parameters: - uuid (string, required): The uuid of the watch to retrieve. Response: - Dial Color (array<Black | Silver | White | Blue | Grey | Mother of pearl | Champagne | Green | Brown | Gold | Transparent | Skeletonized | Pink | Red | Yellow | Purple | Orange | Bordeaux | Bronze | Silver (solid) | Gold (solid) | Meteorite | Turquoise>): - Bezel Material (array<Steel | Rose gold | Yellow gold | Ceramic | Titanium | White gold | Platinum | Red gold | Gold/steel | Aluminum | Plastic | Silver | Carbon | Bronze | Gem-set | Palladium | Tantalum | Tungsten | Rubber | Gold-plated>): - Case Diameter (array<string>): - Crystal (array<Sapphire crystal | Mineral glass | Plexiglass | Plastic | Glass>): - Dial Numerals (array<No numerals | Arabic numerals | Roman numerals | Lines | Gemstones>): - Case Thickness (array<string>): - Water Resistance (array<string>): - Lug Width (array<string>): - Case Material (array<Steel | Rose gold | Titanium | Gold/steel | White gold | Yellow gold | Ceramic | Platinum | Plastic | Red gold | Carbon | Bronze | Aluminum | Silver | Palladium | Tantalum | Sapphire crystal | Gold-plated>): - Style (array<Dive | Field | Pilot | Dress | Digital | Racing>): - Complications (array<Date | Chronograph | Weekday | Gmt | Moon phase | Tachymeter | Month | Perpetual calendar | Alarm | Flyback | Tourbillon | Year | Panorama date | Annual calendar | 4-year calendar | Minute repeater | Double chronograph | Jumping hour | Equation of time | Chiming clock>): - Features (array<Luminous hands | Display back | Luminous indices | Central seconds | Screw-down crown | Chronometer | Rotating bezel | Small seconds | Limited edition | Gemstones and/or diamonds | Luminous numerals | Other | Quick set | Power reserve display | Pvd/dlc coating | Solar watch | Skeletonized | Tempered blue hands | Guilloché dial | Helium valve | World time watch | Master chronometer | Crown left | Screw-down push-buttons | Genevian seal | Vintage | Guilloché dial (handwork) | Smartwatch | One-hand watches | Special edition>): - Movement Type (array<Automatic | Quartz | Manual winding | Solar | Smartwatch>): - Number of Jewels (array<string>): - Power Reserve (array<string>): - Frequency (array<string>): - Image (array<string>): base64 encoded image