**版本：202601**

# 查询市场列表

**GET** `/openapi/2026-01/markets`

查询店铺全部市场及其配置。

## 请求

**Query参数**

- `only_active` boolean

  是否仅返回已启用的市场；默认为 false
- `with_countries_detail` boolean

  是否返回各国家的货币明细；默认为 false

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `markets` object[]

    市场列表

    *   Array \[

    - `id` string

      市场 ID
    - `name` string

      市场名称
    - `is_primary` boolean

      是否为主市场
    - `is_default` boolean

      是否为默认市场
    - `market_status` string

      市场状态：active（启用）或 paused（停用）
    - `countries` string[]

      覆盖的国家（ISO 3166-1 alpha-2）
    - `currency` string

      基本货币（ISO 4217）
    - `symbol` object

      货币符号信息

      - `val` string

        符号字符（如 £）
      - `left` string

        置于金额左侧的符号
      - `right` string

        置于金额右侧的符号
      - `cn_name` string

        货币中文名
      - `title` string

        货币名称
      - `code` string

        货币代码（ISO 4217）
    - `local_currency_enabled` boolean

      是否开启本地货币显示
    - `countries_detail` object[]

      各国家货币明细。仅当请求传 with\_countries\_detail=true 时返回

      *   Array \[

      - `country_code` string

        国家代码（ISO 3166-1 alpha-2）
      - `currency` string

        该国家对应的货币代码
      - `symbol` object

        货币符号信息

        - `val` string

          符号字符（如 £）
        - `left` string

          置于金额左侧的符号
        - `right` string

          置于金额右侧的符号
        - `cn_name` string

          货币中文名
        - `title` string

          货币名称
        - `code` string

          货币代码（ISO 4217）
      - `detail` object

        国家详情

        - `name` string

          国家名称
        - `cn_name` string

          国家中文名
        - `continent` string

          所属大洲
        - `flag` string

          国旗标识
        - `iso_code_2` string

          ISO 3166-1 alpha-2 代码
        - `iso_code_3` string

          ISO 3166-1 alpha-3 代码
      *   \]
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "markets": [
      {
        "id": "string",
        "name": "string",
        "is_primary": true,
        "is_default": true,
        "market_status": "string",
        "countries": [
          "string"
        ],
        "currency": "string",
        "symbol": {
          "val": "string",
          "left": "string",
          "right": "string",
          "cn_name": "string",
          "title": "string",
          "code": "string"
        },
        "local_currency_enabled": true,
        "countries_detail": [
          {
            "country_code": "string",
            "currency": "string",
            "symbol": {
              "val": "string",
              "left": "string",
              "right": "string",
              "cn_name": "string",
              "title": "string",
              "code": "string"
            },
            "detail": {
              "name": "string",
              "cn_name": "string",
              "continent": "string",
              "flag": "string",
              "iso_code_2": "string",
              "iso_code_3": "string"
            }
          }
        ]
      }
    ]
  }
}
```