Create a market with `marketCreate`, providing a `name` and an array of `MarketRegionCountryInput` objects identifying the countries in the market.
Configure currency behavior by calling `marketCurrencySettingsUpdate` with `localCurrencies: true` to enable buyer-local currency display, or `false` to pin to the market's base currency.
Read contextual prices by querying `product` and using the `contextualPricing(context: {country: XX})` field to retrieve prices in the market's currency.
To set market-specific price overrides, associate a catalog (via `catalogCreate`) with the market context and apply a price list with fixed or percentage adjustments.
Test by calling the Storefront API with a `X-Shopify-Country` buyer IP header or the `buyerIdentity.countryCode` on a cart to verify correct price resolution.
Use the `markets` query to list all markets and verify each has the expected currency settings and catalog association.
Known gotchas
The `contextualPricing` field on products requires a country code context; querying without context returns the store's default pricing and will not reflect market overrides.
Enabling local currencies activates automatic FX conversion using Shopify's exchange rates; if you need fixed local prices, use a catalog with a price list instead.
As of API version 2025-04, the Markets API introduced breaking changes to how conditions and regions are structured — verify your API version before migrating existing market integrations.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp