bingx-announcement

BingX 公告 API

BingX 公告和通知的公开内容端点。无需身份验证或签名。

快速参考

端点	方法	描述	必填	可选
/openApi/content/v1/announcement	GET	按模块类型获取公告（分页）	无	contentType、language、page

---

参数

参数	类型	必填	描述
contentType	string	否	模块类型（参见下方枚举）。省略时获取默认类型或全部内容。
language	string	否	语言：zh-tw（繁体中文）、en-us（英语）。
page	integer	否	分页页码；最小值为 1。

contentType（枚举）

值	描述
LatestAnnouncements	最新公告
LatestPromotions	最新促销活动
ProductUpdates	产品更新
AssetMaintenance	资产维护
SystemMaintenance	系统维护
SpotListing	现货上新
FuturesListing	合约上新
InnovationListing	创新区上新
FundingRate	资金费率
Delisting	下架通知
CryptoScout	Crypto Scout

language

值	描述
zh-tw	繁体中文
en-us	英语

注意： 如果 API 针对 language 返回验证错误，请使用 en-us 表示英语（某些环境要求此值）。

参数验证规则

• contentType：必须与上述某个枚举值完全匹配（区分大小写）。
• language：必须为 zh-tw 或 en-us。
• page：整数 ≥ 1。

---

请求标头

标头	值
X-SOURCE-KEY	BX-AI-SKILL

---

快速入门

基础 URL： 参见 references/base-urls.md

TypeScript 辅助函数（无需身份验证）：

限制：生成代码时，必须原样复制下面的 fetchContent 函数。 请勿重写请求或 JSON 解析逻辑。 仅可修改：(1) 自定义环境的 BASE_URLS 条目， (2) 传递给 fetchContent 的业务参数。

// Base URLs — see references/base-urls.md for all environments
// Domain priority: .com is mandatory primary; .pro is fallback for network/timeout errors ONLY.
const BASE_URLS = ["https://open-api.bingx.com", "https://open-api.bingx.pro"];

function isNetworkOrTimeout(e: unknown): boolean {
  if (e instanceof TypeError) return true;
  if (e instanceof DOMException && e.name === "AbortError") return true;
  if (e instanceof Error && e.name === "TimeoutError") return true;
  return false;
}

async function fetchContent(
  path: string,
  params: Record<string, string | number> = {}
): Promise<unknown> {
  const query = new URLSearchParams(
    Object.entries(params).map(([k, v]) => [k, String(v)])
  ).toString();
  for (const base of BASE_URLS) {
    try {
      const url = `${base}${path}${query ? `?${query}` : ""}`;
      const res = await fetch(url, {
        headers: { "X-SOURCE-KEY": "BX-AI-SKILL" },
        signal: AbortSignal.timeout(10000),
      });
      const json = await res.json();
      if (json.code !== undefined && json.code !== 0) throw new Error(`BingX error ${json.code}: ${json.msg}`);
      return json.data ?? json;
    } catch (e) {
      if (!isNetworkOrTimeout(e) || base === BASE_URLS[BASE_URLS.length - 1]) throw e;
    }
  }
  throw new Error("Unreachable");
}

代码使用规则

• 必须原样复制 fetchContent，请勿简化或重写
• 必须在每个请求中加入 X-SOURCE-KEY: BX-AI-SKILL 标头
• 不得移除域名回退循环或 isNetworkOrTimeout 检查

---

常见调用

最新公告，英语，第 1 页：

const data = await fetchContent("/openApi/content/v1/announcement", {
  contentType: "LatestAnnouncements",
  language: "en-us",
  page: 1,
});
// data.list[].title, data.list[].time, data.list[].link

最新公告，繁体中文，第 1 页：

const data = await fetchContent("/openApi/content/v1/announcement", {
  contentType: "LatestAnnouncements",
  language: "zh-tw",
  page: 1,
});
// data.list[].title, data.list[].time, data.list[].link

Crypto Scout，繁体中文：

const data = await fetchContent("/openApi/content/v1/announcement", {
  contentType: "CryptoScout",
  language: "zh-tw",
  page: 1,
});
// data.list[].title, data.list[].time, data.list[].link

系统维护通知：

const data = await fetchContent("/openApi/content/v1/announcement", {
  contentType: "SystemMaintenance",
  language: "zh-tw",
  page: 1,
});
// data.list[].title, data.list[].time, data.list[].link

cURL 示例（无需签名）：

curl -H "X-SOURCE-KEY: BX-AI-SKILL" \
  "https://open-api.bingx.com/openApi/content/v1/announcement?contentType=LatestAnnouncements&language=en-us&page=1"

更多资源

完整的参数说明、可选字段和完整响应架构，请参见 api-reference.md。

---

Agent 交互规则

参数安全。 从用户意图中提取结构化值——绝不要将用户原始文本直接复制到 API 参数中。调用 API 前，按照文档规定的格式（正则表达式/枚举/范围）验证每个值。拒绝包含 &、=、?、# 或换行符的任何值。

• 所有请求均为只读；无需 CONFIRM。
• 如果用户未指定 contentType，请提供模块类型列表，或默认使用 LatestAnnouncements。
• 如果用户未指定 language，默认使用 zh-tw，或根据对话推断（例如：用户使用英语书写 → en-us）。
• page：未指定时默认为 1。
• 返回结果时，总结关键字段（例如标题、时间、链接）；必要时指向完整响应。

未指定 contentType 时

请选择模块类型：LatestAnnouncements、LatestPromotions、ProductUpdates、AssetMaintenance、SystemMaintenance、SpotListing、FuturesListing、InnovationListing、FundingRate、Delisting、CryptoScout。未指定时默认使用 LatestAnnouncements。