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 includes. A key without it gets 403.

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

Run export GOLFDEV_API_KEY='sk_test_…' with your key in the same terminal first. Leave $GOLFDEV_API_KEY as written; the shell replaces it with your key. How to set your key

Response cut to seven fields:

{
  "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 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:

{
  "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.

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:

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:

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.