ドキュメントのメニューexpand_more

ガイド

エンドポイント

appsすべての API

function指標の計算方法

← MCP ツールの一覧に戻る

MCP ツール

get_rankings

「指標別ランキング」の MCP ツールです。1 回の実行で 10 トークンを消費します。

このページの要点

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

このツールが返すもの

選んだ指標（配当利回り、PER、ROE、年初来の騰落率など）で、上位の銘柄を並べて返します。業種で絞り込むこともできます。比率は 0〜1 の小数（0.1 = 10%）です。並べるのは事業会社の株だけで（ETF・REIT・優先株・TOKYO PRO Market・上場廃止は除く）、時価総額のランキング以外は時価総額 50 億円以上だけ。ROE・ROA の 100% 超と成長率（CAGR）の年 100% 超は外れ値として除きます。

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

Top/bottom ranked Japanese listed companies by a single metric (dividend yield, PER, PBR, ROE, market cap, price change, CAGRs, consecutive non-decrease years (including flat years)). 指標別ランキング。Costs 10 tokens.

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

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

chat配当利回りの高い順に銘柄を並べて、高配当株の候補を探す
chat年初来の上昇率が大きい銘柄を確認する
chat業種の中で ROE が高い会社を見つける

引数

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

引数	型	必須	説明
metric	stringmarketCap \| per \| pbr \| psr \| roe \| roa \| dividendYield \| evToEbitda \| changePct1d \| changePct1w \| changePct1m \| changePctYtd \| dividendCagr3y \| dividendCagr5y \| revenueCagr3y \| revenueCagr5y \| epsCagr3y \| epsCagr5y \| progressiveDividendYears	必須	ランキングに使う指標。指定できる値（marketCap, per, pbr, psr, roe, roa, dividendYield, evToEbitda, changePct1d, changePct1w, changePct1m, changePctYtd, dividendCagr3y, dividendCagr5y, revenueCagr3y, revenueCagr5y, epsCagr3y, epsCagr5y, progressiveDividendYears）
order	stringasc \| desc	—	並び順。desc = 大きい順（既定）、asc = 小さい順既定値: desc
sector	string	—	東証 33 業種コード（例: 3700 = 輸送用機器）。一覧は /stable/available-sectors
limit	integer	—	返す件数の上限（既定 100、最大 100）既定値: 100範囲: 1〜100

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

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

指標別ランキングGET /stable/rankings10 トークン

例

AI への質問の例

ZENITH Code のデータを使って、次のことを手伝ってください: 配当利回りの高い順に銘柄を並べて、高配当株の候補を探す

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_rankings",
    "arguments": {
      "metric": "dividendYield"
    }
  }
}

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

curl "https://api.zenithcode.net/stable/rankings?metric=dividendYield" \
  -H "x-api-key: YOUR_API_KEY"

注意点

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

warning

取引所データの扱い

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

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

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

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

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

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

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

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

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

get_rankings は何を返しますか？expand_more

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

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

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

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

info

免責

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

このツールが返すもの

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

引数

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

例

注意点

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

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

関連記事