Authenticate with the Admin GraphQL API using a token with the `write_markets` access scope.
Query `markets` to retrieve the target market's `id` (a GID string such as `gid://shopify/Market/123`).
Call the `marketUpdate` mutation with the market `id` and a `MarketUpdateInput` that includes the `currencySettings` field (set `baseCurrency` or toggle `localCurrencies` as needed).
Check the `userErrors` array in the response; a non-empty array means the mutation was rejected — inspect `field` and `message` to diagnose.
Confirm the change by querying the `market` object and inspecting `currencySettings.baseCurrency.currencyCode`.
Known gotchas
`marketCurrencySettingsUpdate` was deprecated in April 2025 (API version 2025-04) and will be removed; use `marketUpdate` for all currency-settings changes going forward.
The `baseCurrency` of a market can only be set to a currency that is already enabled on the store; attempting an unsupported currency returns a user error.
Local-currency conversion uses Shopify's exchange-rate service; prices in secondary currencies are estimates and may differ from manually set price lists.
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