---
title: "Read golf club launch prices (MSRP) with view=market"
description: "intro_price is a club's launch MSRP per market, in minor units. Read it with view=market, filter with msrp_min and msrp_max, and keep markets apart."
summary: "GolfAPI.dev launch prices. Add view=market to any club list or record: GET https://api.golfapi.dev/drivers/optm-x-driver?view=market. intro_price is a list of {market (ISO 3166-1), msrp_minor (integer, the currency's minor units: $599 is 59900, ¥176,000 is 176000), currency (ISO 4217), tax_included}. It is the launch MSRP, never converted between currencies. msrp_min and msrp_max are inclusive bounds in minor units; msrp_market picks the market they compare (US by default). An iron's price is for one iron. Auth: Bearer API key with the market entitlement. A missing entry for a market is Not published."
url: "https://golfapi.dev/blog/launch-prices-view-market/"
published: "2026-10-29"
updated: "2026-11-12"
tags: ["How-to"]
---

# Read golf club launch prices (MSRP) with view=market

Every club can carry the price it launched at: the maker's suggested retail price on release day, in the market where that price was stated. You read it from the Market document.

## Request the Market document

Add `view=market` to any club list or record. The Market document carries the club's identity and `intro_price`, and leaves out the specifications. It needs the `market` entitlement, which the [Pro plan](https://golfapi.dev/pricing/) includes. A key without it gets `403`.

```sh
curl 'https://api.golfapi.dev/drivers/optm-x-driver?view=market' \
  -H "Authorization: Bearer $GOLFDEV_API_KEY"
```

Response cut to seven fields:

```json
{
  "id": "clb_01M21MDXARYJ4WQCR8E0Z2ZQ03",
  "slug": "optm-x-driver",
  "name": "OPTM X Driver",
  "club_type": "driver",
  "manufacturer": {
    "slug": "cobra",
    "name": "Cobra"
  },
  "release_year": 2026,
  "released": "2026-01-20",
  "intro_price": [
    {
      "market": "US",
      "msrp_minor": 59900,
      "currency": "USD",
      "tax_included": false
    }
  ]
}
```

To get specifications and prices for the same clubs, make two requests, one per view, and join them on `id`.

In a chat, an assistant connected to the [MCP server](https://golfapi.dev/mcp) reads the same document. Ask "What was the US launch price of the Cobra OPTM X Driver?", and it calls `get_club` with `view: market`. A Free account's test key answers for the 2025 and 2026 drivers in the sample, 63 of which had a US launch price on 13 November 2026. Every other club needs Pro.

## Read msrp_minor in minor units

`msrp_minor` is an integer in the currency's smallest unit. US prices are in cents, so `59900` is $599.00 and `64999` is $649.99. Japanese yen has no minor unit, so `176000` is ¥176,000. Divide by 100 for USD and display JPY as stored. Do not round: the catalog stores the amount the launch source states.

Honma's 2026 BERES 10 Driver is priced only in Japan:

```json
{
  "intro_price": [
    {
      "market": "JP",
      "msrp_minor": 176000,
      "currency": "JPY",
      "tax_included": true
    }
  ]
}
```

`tax_included` says whether the stated price includes sales tax. US entries are `false`. A Japanese entry is `true` when the source states the price with consumption tax.

## Keep markets apart

A club can carry one entry per market. Prices are never converted between currencies, so a US and a Japanese price for one club are two separate facts. To compare clubs, pick one market and use only that market's entries. A club without an entry for that market has no published launch price there.

| Club type | Published | With a launch price | US entries | JP entries |
| --- | --- | --- | --- | --- |
| Drivers | 462 | 373 | 345 | 29 |
| Mini-drivers | 19 | 17 | 16 | 0 |
| Fairway woods | 389 | 321 | 271 | 51 |
| Hybrids | 298 | 242 | 204 | 39 |
| Irons | 428 | 385 | 359 | 27 |
| Wedges | 70 | 65 | 65 | 0 |
| Putters | 653 | 627 | 616 | 26 |

Counts as of 12 November 2026. One mini-driver also carries a GB entry. Read current counts from `GET /coverage`.

## Filter by price

`msrp_min` and `msrp_max` are inclusive bounds in minor units. They compare the US price unless `msrp_market` names another market, and they work on any view. List drivers that launched in the US at $500 to $599.99:

```sh
curl 'https://api.golfapi.dev/drivers?msrp_min=50000&msrp_max=59999&fields=id,name,release_year&limit=50' \
  -H "Authorization: Bearer $GOLFDEV_API_KEY"
```

List hybrids that launched in Japan at ¥40,000 or less:

```sh
curl 'https://api.golfapi.dev/hybrids?msrp_market=JP&msrp_max=40000&view=market&limit=50' \
  -H "Authorization: Bearer $GOLFDEV_API_KEY"
```

A club with no price in the compared market never matches a price filter. A market with no prices in the catalog returns `400` naming the markets that have them.

## Irons are priced per club

An iron's `intro_price` is the launch price of one iron in the stock build. Where the launch source states only a set price and the number of clubs in the set, the price is the set price divided by the set size. Multiply by the set size your user is buying.

## A launch price is historical

`intro_price` is the MSRP at release. It does not give today's price, and it does not say whether the club is still sold. A label such as "launched at $599" describes it accurately. For the trend across years, see [driver launch prices, 2020 to 2026](https://golfapi.dev/blog/driver-launch-prices-2020-2026/).