AI エージェントに日本株を調べさせる

トークンは、表のツールを 1 回ずつ呼んだ場合の合計です。実際に呼ぶツールと回数はモデルによって変わります。

• savings社名から調べるときは、まず search_company で証券コードを確かめさせます。推測した証券コードで呼ぶと、別の会社のデータを取ることがあります。
• savings引数 limit を小さくして、必要な期間・件数だけを取らせます。応答が長いほど、AI の入力（コンテキスト）も消費します。
• savingslist_stocks・list_etfs は 1 回 100 トークンです。条件で絞るなら screen_stocks や get_rankings（10 トークン）で足ります。
• savings有価証券報告書の本文（get_annual_report_text）は、引数 tag で節を絞らせます。省略すると目次だけが返ります。
• savings残りのトークンは get_usage（1 トークン）で確かめられます。API を直接呼んだ場合は、応答ヘッダー X-Monthly-Quota-Remaining にも出ます。

"provenance": {
  "source": "edinet",
  "docId": "S100XXXX",
  "announcedAt": "2026-06-24",
  "sourceUrl": "https://disclosure2.edinet-fsa.go.jp/WZEK0040.aspx?S100XXXX"
}

AI への指示（システムプロンプト）の例です。必要に応じて書き換えてください。

日本株の数字は、必ず ZENITH Code のツールで取得した値だけを使ってください。
各数字のあとに、出典（provenance.source と docId、または sourceUrl）を書いてください。
比率は 0〜1 の小数で返るので、百分率に直して示してください。
429 が返ったら、Retry-After の秒数だけ待ってから 1 回だけ再試行してください。
株価そのものと株価と同じ単位の値、TDnet の書類へのリンクは、第三者向けの回答に含めないでください。
売買の推奨はしないでください。

1. 429（rate_limit_exceeded）では Retry-After を待つ

   1 分あたりの上限を超えると、HTTP 429 と error: rate_limit_exceeded が返ります。Retry-After ヘッダー（秒）か応答の retryAfter の時間を待ってから再試行させます。

2. 429（quota_exceeded）では再試行しない

   月間のトークンを使い切った場合も 429 ですが、error は quota_exceeded です。翌月（UTC）の初めまで回復しないので、再試行を繰り返させないでください。

3. 503（origin_busy）も Retry-After を待つ

   データ元が混んでいて古いキャッシュも無いときは、503 と Retry-After が返ることがあります。このときはトークンを消費しません。

4. 取引所データを第三者に渡さない

   株価そのもの、株価と同じ単位の値（始値・高値・安値・終値、移動平均、期間の高値・安値、前日比・騰落率）、TDnet の書類そのもの（PDF・本文・リンク）は取引所データです。どのプランでも、AI の回答を通じて第三者に示すことはできません（利用規約 第 8 条第 4 項）。

5. 他人向けの AI は Business プラン以上

   自分が使う AI エージェントにデータを参照させるのは、どのプランでもできます（第 8 条第 1 項第 2 号）。回答を自分以外の人に提供する場合や、サービスの利用者の求めに応じて AI に参照させる場合は、Business プラン以上が必要です（同条第 2 項）。

6. 制限を回避しない・売買を勧めない

   利用制限を回避するために、複数のアカウントや API キーを併用させないでください（利用規約 第 7 条）。ZENITH Code のデータは投資助言ではないので、AI の回答でも売買を勧める表現は避けます。

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit of 60 requests/minute exceeded.",
  "retryAfter": 12
}

上は 1 分あたりの上限を超えたときの応答の例です（数値は例）。

• error比率は 0〜1 の小数です。API では 0.082、画面では 8.2% です。百分率と取り違えると 100 倍の誤りになります。
• error四半期の業績は、期首からの累計です。第 3 四半期（Q3）は 9 か月分なので、3 か月分は前の累計を引いて求めます。
• error決算期は fiscalPeriod（その行の期末の年月）と period（Q1〜Q3・FY）で表します。fiscalPeriod 2026-03・period FY は 2026 年 3 月期です。四半期の行は四半期末の年月なので、2026-06・Q1 は 2027 年 3 月期の第 1 四半期です。fiscalYear という項目はありません。
• errornull は「開示がない・当てはまらない」を表し、0 とは違います。IFRS の会社の経常利益（ordinaryIncome）は null です。
• error金額は円の整数です。決算書の「百万円」の単位のままではありません。
• error同じ期の値は、決算短信の値が先に返り、有価証券報告書の提出後に確定値へ置き換わります。provenance.source で区別できます。