無料でAPIキー取得
ドキュメントのメニューexpand_more
travel_exploreAPI ビューワーで試す

ガイド

エンドポイント

search
appsすべての API
function指標の計算方法
← MCP ツールの一覧に戻る

MCP ツール

get_batch_quotes

「複数銘柄の株価（最大 50 銘柄）」の MCP ツールです。1 回の実行で 10 トークンを消費します。

このページの要点

  • check_circle対応する REST エンドポイントは /stable/batch-quote です。応答の形も同じです。
  • check_circle1 回の実行で 10 トークンを消費します。エンドポイントを直接呼んだときと同じです。
  • check_circle必須の引数: symbols

このツールが返すもの

最大 50 銘柄分の直近の終値・騰落率・時価総額を 1 回で返します。項目は株価（最新）と同じで、symbols=7203,6758,9984 のようにカンマ区切りで指定します。結果は指定した順に並び、重複は 1 件にまとめ、見つからない銘柄は found=false と null で返すので、全体が失敗することはありません。

AI クライアントに渡る説明

Latest price, price date, change percentages and market cap for up to 50 companies in ONE call (same fields as get_quote). For PER, dividend yield and CAGRs of a list use get_batch_key_metrics_latest. Results follow the request order; unknown symbols come back with found=false instead of failing the call. Prefer this over repeated get_quote calls when comparing a list. 最大50銘柄の株価・騰落率・時価総額を1回で取得（get_quote と同じ項目）。リクエスト順で、見つからない銘柄は found=false。PER・配当利回りは get_batch_key_metrics_latest。

AI はこの説明を読んでツールを選びます。英語と日本語を併記しています。

このツールで答えられること

  • chatウォッチリストの全銘柄の株価を 1 回で更新する
  • chat保有銘柄の評価額を一覧で計算する
  • chat比較したい数銘柄の騰落率をまとめて取得する

引数

引数の名前は、REST のクエリ引数と同じです。必須でない引数は省略できます。

引数型必須説明
symbolsstring必須証券コードをカンマ区切りで最大 50 個（例: 7203,6758,9984）。重複は 1 件にまとめます

対応する REST エンドポイント

このツールは /stable/batch-quote を呼びます。1 回 10 トークンで、認証と月間トークンは REST と共通です。

複数銘柄の株価（最大 50 銘柄）GET /stable/batch-quote10 トークン

例

AI への質問の例

ZENITH Code のデータを使って、次のことを手伝ってください: ウォッチリストの全銘柄の株価を 1 回で更新する

AI クライアントが送る呼び出し（tools/call）の例です。必須の引数だけを入れています。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_batch_quotes",
    "arguments": {
      "symbols": "7203,6758,9984"
    }
  }
}

同じデータを REST で取る場合の例です。

curl "https://api.zenithcode.net/stable/batch-quote?symbols=7203,6758,9984" \
  -H "x-api-key: YOUR_API_KEY"

注意点

  • info応答の形と項目の意味は、対応するエンドポイントの API ドキュメントと同じです。
  • info読み取り専用のツールです。データの書き込みや設定の変更はしません。
warning

取引所データの扱い

応答に株価そのもの、株価と同じ単位の値、TDnet の書類そのもの（PDF・本文・リンク）が含まれる場合、その部分は取引所データです。どのプランでも、AI の回答などを通じて第三者に示すことはできません（利用規約 第 8 条第 4 項）。

よくある質問（投資家・開発者向け）

get_batch_quotes を使うには何が必要ですか？expand_more

MCP に対応した AI クライアントと、ZENITH Code の API キーです。すべてのプランで使えます。設定は「MCP の使い方」をご覧ください。

get_batch_quotes は 1 回で何トークン消費しますか？expand_more

10 トークンです。/stable/batch-quote を直接呼んだときと同じです。

get_batch_quotes の結果を自社サービスに表示できますか？expand_more

第三者への表示は Business プラン以上でできます。取引所データ（株価そのもの・株価と同じ単位の値・TDnet の書類そのもの）は、どのプランでも表示できません。詳しくは「表示してよいデータ・いけないデータ」をご覧ください。

よくある質問（AI・研究者向け）

get_batch_quotes は何を返しますか？expand_more

最大 50 銘柄分の直近の終値・騰落率・時価総額を 1 回で返します。項目は株価（最新）と同じで、symbols=7203,6758,9984 のようにカンマ区切りで指定します。結果は指定した順に並び、重複は 1 件にまとめ、見つからない銘柄は found=false と null で返すので、全体が失敗することはありません。

get_batch_quotes の応答の出典はどこで確かめられますか？expand_more

出典の項目（provenance や sourceUrl）がある応答では、その値で原本を確かめられます。項目の有無は /stable/batch-quote の API ドキュメントの応答の項目をご覧ください。

get_batch_quotes と一緒に使うツールは何ですか？expand_more

よく組み合わせるのは get_quote, get_batch_key_metrics_latest, get_returns です。社名から始める場合は、先に search_company で証券コードを確かめます。

関連記事

API ドキュメント: 複数銘柄の株価（最大 50 銘柄）/stable/batch-quoteget_quoteQuoteMCP ツールの一覧すべての MCP ツールをカテゴリ別にAI エージェントに日本株を調べさせる質問の例・トークンの見積もり・出典・ルール
info

免責

このページは情報提供を目的としたもので、投資助言ではありません。特定の銘柄の売買を勧めるものでもありません。データの利用条件は、利用規約と「データの出典と利用条件」の記載が優先します。