ドキュメントのメニューexpand_more
MCP ツール
get_market_breadth
このページの要点
- check_circle対応する REST エンドポイントは /stable/market-breadth です。応答の形も同じです。
- check_circle1 回の実行で 1 トークンを消費します。エンドポイントを直接呼んだときと同じです。
- check_circle必須の引数: なし
このツールが返すもの
最新の取引日の値上がり・値下がり・変わらずの銘柄数、騰落レシオ、52 週の新高値・新安値の銘柄数、売買代金の合計を返します。先頭が市場全体（ALL）で、groupBy=sector を指定すると東証 33 業種ごとの行が加わります。既定は普通株で、市場区分でも絞り込めます。
AI クライアントに渡る説明
How broad is the market move? Advancers, decliners, unchanged, advance/decline ratio, number of new 52-week highs and lows and total trading value for the latest trading day — whole market first, optionally one row per TSE 33-sector (groupBy=sector). Common stocks by default; filter by market segment (prime / standard / growth). 騰落銘柄数・騰落レシオ・新高値/新安値の数・売買代金（全体と業種別）。Costs 1 token.
AI はこの説明を読んでツールを選びます。英語と日本語を併記しています。
このツールで答えられること
- chat今日の市場が全面高か、一部の銘柄だけの上昇かを確認する
- chat騰落レシオで相場の過熱感の目安をつける
- chat業種ごとの値上がり銘柄数を比べる
引数
引数の名前は、REST のクエリ引数と同じです。必須でない引数は省略できます。
| 引数 | 型 | 必須 | 説明 |
|---|---|---|---|
| groupBy | stringnone | sector | — | sector を指定すると東証 33 業種ごとの行を追加。none（既定）は全体のみ既定値: none |
| market | stringprime | standard | growth | — | 市場区分（prime = プライム、standard = スタンダード、growth = グロース） |
| includeEtf | boolean | — | true で ETF・REIT も含める（既定は普通株だけ） |
対応する REST エンドポイント
このツールは /stable/market-breadth を呼びます。1 回 1 トークンで、認証と月間トークンは REST と共通です。
例
AI への質問の例
ZENITH Code のデータを使って、次のことを手伝ってください: 今日の市場が全面高か、一部の銘柄だけの上昇かを確認する
AI クライアントが送る呼び出し（tools/call）の例です。必須の引数だけを入れています。
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_market_breadth",
"arguments": {}
}
}同じデータを REST で取る場合の例です。
curl "https://api.zenithcode.net/stable/market-breadth" \ -H "x-api-key: YOUR_API_KEY"
注意点
- info応答の形と項目の意味は、対応するエンドポイントの API ドキュメントと同じです。
- info読み取り専用のツールです。データの書き込みや設定の変更はしません。
取引所データの扱い
応答に株価そのもの、株価と同じ単位の値、TDnet の書類そのもの（PDF・本文・リンク）が含まれる場合、その部分は取引所データです。どのプランでも、AI の回答などを通じて第三者に示すことはできません（利用規約 第 8 条第 4 項）。
よくある質問（投資家・開発者向け）
get_market_breadth を使うには何が必要ですか？expand_more
MCP に対応した AI クライアントと、ZENITH Code の API キーです。すべてのプランで使えます。設定は「MCP の使い方」をご覧ください。
get_market_breadth は 1 回で何トークン消費しますか？expand_more
1 トークンです。/stable/market-breadth を直接呼んだときと同じです。
get_market_breadth の結果を自社サービスに表示できますか？expand_more
第三者への表示は Business プラン以上でできます。取引所データ（株価そのもの・株価と同じ単位の値・TDnet の書類そのもの）は、どのプランでも表示できません。詳しくは「表示してよいデータ・いけないデータ」をご覧ください。
よくある質問（AI・研究者向け）
get_market_breadth は何を返しますか？expand_more
最新の取引日の値上がり・値下がり・変わらずの銘柄数、騰落レシオ、52 週の新高値・新安値の銘柄数、売買代金の合計を返します。先頭が市場全体（ALL）で、groupBy=sector を指定すると東証 33 業種ごとの行が加わります。既定は普通株で、市場区分でも絞り込めます。
get_market_breadth の応答の出典はどこで確かめられますか？expand_more
出典の項目（provenance や sourceUrl）がある応答では、その値で原本を確かめられます。項目の有無は /stable/market-breadth の API ドキュメントの応答の項目をご覧ください。
get_market_breadth と一緒に使うツールは何ですか？expand_more
よく組み合わせるのは get_market_movers, get_new_highs_lows, get_sector_performance です。社名から始める場合は、先に search_company で証券コードを確かめます。
関連記事
免責
このページは情報提供を目的としたもので、投資助言ではありません。特定の銘柄の売買を勧めるものでもありません。データの利用条件は、利用規約と「データの出典と利用条件」の記載が優先します。