查询市场列表

GET 
/openapi/2026-01/markets

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

请求

Query参数

only_active boolean

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

with_countries_detail boolean

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
markets object[]
市场列表
Array [
idstring
市场 ID
namestring
市场名称
is_primaryboolean
是否为主市场
is_defaultboolean
是否为默认市场
market_statusstring
市场状态：active（启用）或 paused（停用）
countriesstring[]
覆盖的国家（ISO 3166-1 alpha-2）
currencystring
基本货币（ISO 4217）
symbol object
货币符号信息
valstring
符号字符（如 £）
leftstring
置于金额左侧的符号
rightstring
置于金额右侧的符号
cn_namestring
货币中文名
titlestring
货币名称
codestring
货币代码（ISO 4217）
local_currency_enabledboolean
是否开启本地货币显示
countries_detail object[]
各国家货币明细。仅当请求传 with_countries_detail=true 时返回
Array [
country_codestring
国家代码（ISO 3166-1 alpha-2）
currencystring
该国家对应的货币代码
symbol object
货币符号信息
valstring
符号字符（如 £）
leftstring
置于金额左侧的符号
rightstring
置于金额右侧的符号
cn_namestring
货币中文名
titlestring
货币名称
codestring
货币代码（ISO 4217）
detail object
国家详情
namestring
国家名称
cn_namestring
国家中文名
continentstring
所属大洲
flagstring
国旗标识
iso_code_2string
ISO 3166-1 alpha-2 代码
iso_code_3string
ISO 3166-1 alpha-3 代码
]
]

示例

{
  "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"
            }
          }
        ]
      }
    ]
  }
}