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	暗号資産スカウト

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

暗号資産スカウト、繁体字中国語：

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 を参照してください。

---

エージェントの操作ルール

パラメーターのセキュリティ。 ユーザーの意図から構造化された値を抽出してください。ユーザーの生のテキストを 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 を使用します。