メインコンテンツへスキップ
使い方

はじめての検証

使い方

まずは準備のいらないサンプルで、条件設定から結果の確認までを1回通します。実データ接続はそのあとで構いません。必要になったときの準備も、このページの後半で案内します。

最初の1回に必要

登録・API キーなし

内蔵サンプルで画面と結果の読み方を確かめられます。実データには PC・拡張機能 Zephris Connector・API キーが必要です。

最初にすること

サンプルで、1回の検証を終える。

拡張機能や J-Quants API キーの準備前でも始められます。最初は設定を作り込まず、 画面を上から順に見て、結果までたどり着くことを目標にします。

  1. 01

    サンプルを開く

    「サンプルで始める」を押すと、登録や API キーなしで試せる設定が読み込まれます。

  2. 02

    銘柄と期間を確認する

    「01 銘柄選定」と「02 期間設定」で、何を・いつのデータで確かめるかを確認します。最初は値を変えなくても構いません。

  3. 03

    買う条件（エントリー）を確認する

    「03 買う条件（エントリー）」は、検証上で買うきっかけになる条件です。専門語の意味が分からないときは用語集を開けます。

  4. 04

    売る条件（エグジット）を確認する

    「04 売る条件（エグジット）」は、検証上で手放す条件です。買う条件と売る条件を対で確認します。

  5. 05

    資金とコストを確認する

    「05 資金とコスト」で、元手、手数料、税などの前提を確認します。結果はこの前提によって変わります。

    実際の画面

    設定済みの条件を確認して、サンプルを実行します

    生成サンプルの検証条件と実行ボタン
    • 検証条件の要約
    • 設定済みの項目
    • 「サンプルで検証」ボタン
    生成サンプルには検証条件が入力済みです。条件を確認し、画面上部の「サンプルで検証」から実行します。この例ではオンボーディングガイドを閉じていますが、検証条件と実行ボタンは変わりません。
  6. 06

    検証して、結果を読む

    「06 戦略フロー」で条件のつながりを見直して実行します。「07 検証結果」では、累積リターンだけでなく、買い持ちとの差、最大下落率、取引回数、結果の信頼性を一緒に確認します。

  7. 07

    結果を保存して、あとで見返す

    残したい結果は保存し、「履歴」または「検証ケース」で条件・前提と一緒に見返します。良い数値だけでなく、比較対象や注意点も記録します。

    実際の画面

    結果は、複数の指標を確かめてから保存します

    生成サンプルの主要な検証指標

    同じ検証結果の別タブです。間の内容は省略しています。

    検証結果の記録と出力タブ
    • 累積リターンと比較対象
    • 結果の信頼性に関する注意
    • 履歴保存・JSON 出力
    生成サンプル（合成データ）の操作例です。累積リターンだけでなく、最大下落率・取引回数・信頼性を一緒に確認します。「履歴に保存」は結果一式をブラウザ内に残します。保存後は履歴画面で解釈や次の問いを検証ケースとして整理でき、JSON は集約サマリをブラウザ内でファイルに書き出します。
サンプルで始める 画面の用語を先に見る保存した結果の見返し方を確認

この例は操作と結果の読み方を確認するためのもので、特定の戦略や売買判断を勧めるものではありません。

実データを使う場合

実データ接続は、サンプルを試したあとで。

ここから先は、ご自身の J-Quants 契約で実データを使う方だけが必要な手順です。接続、データの扱い、つまずいたときの確認先を分けて追えます。

J-Quants API キーの用意、拡張機能 Zephris Connector のインストール、キーの登録を順番に説明します。 サンプルだけを使う間は、この準備は不要です。

API キーは、Zephris に預けるのではなく、ブラウザ内で扱う設計です。詳しい仕組みは データの通り道 でお伝えします。

「移動平均クロスとは何か」「シャープレシオの読み方」など、用語や検証手法の 解説は よくある質問 と 用語集 にまとめています。

検証の結果をどこまで信じてよいか —— 生存者バイアスや約定の現実性などの前提は 検証の方法論 で説明しています。

買う条件（エントリー）・売る条件（エグジット）をどう組み合わせるか迷ったら、既存の条件カタログを 使った組み方を 戦略レシピ にまとめています。

実データの準備

3つのステップ。

  1. 01J-Quants の API キーを用意する所要時間 5–8 分
  2. 02Zephris の拡張機能をインストールする所要時間 1 分
  3. 03API キーをブラウザに登録する所要時間 1 分

※ 表示は各ステップの操作の目安です。J-Quants 側の審査・API キー発行の待ち時間は、環境により変わるため含みません。

STEP 01

J-Quants の API キーを用意する

Zephris は、日本株のヒストリカルデータを J-Quants API から 取得します。データは、ご自身の J-Quants 契約と API キーで取得していただきます。

取得できる期間や項目は、ご契約の J-Quants API の契約プランによって異なります。 長期のバックテストを行う場合は、取得したい期間・項目がご自身の契約プランで 利用できるかを、J-Quants API サイトでご確認ください。

J-Quants プランと株価日足の期間（目安）

Free
12 週間遅延した最新日までの過去 2 年分
Light
過去 5 年分
Standard
過去 10 年分
Premium
J-Quants が提供する全期間（最大 20 年）

Zephris は J-Quants の契約プランを自動判定しません。設定画面で手動選択したプランを、「02 期間設定」で選べる期間の制御と実行前の確認に使います。実際に返る開始日・終了日は、銘柄の上場日やデータの提供状況により、この目安より短くなることがあります。

期間以外の主な違い

市場との差（TOPIX）を確認する
J-Quants の Light 以上が必要です。Free では TOPIX を取得できません。
配当を検証に反映する
J-Quants の Premium 契約が必要です。受け取り／再投資から選べます。

生成サンプルの市場比較は、画面確認用のサンプルベンチマークで、J-Quants の TOPIX ではありません。

※ 各プランの費用・取得できる期間や項目の詳細・最新情報は、J-Quants API サイトでご確認ください。本表は目安で、投資判断やプランの推奨を行うものではありません。

J-Quants API サイトを開く ↗登録手順・プランの最新情報は、J-Quants API サイトでご確認ください

※ Zephris Connector は JPX グループおよび株式会社 JPX 総研 (JPX Market Innovation & Research, Inc.) の関連会社・提携先・公式パートナーではありません。

すでに API キーをお持ちの方は、Step 02 へお進みください。

STEP 02

Zephris の拡張機能をインストールする

Zephris の API キー連携は、Chrome / Edge 拡張機能 Zephris Connector が担います。拡張機能の中で API キーを預かり、Web アプリ (zephris.app) から の問い合わせに応じてデータ取得を仲介する構成です。

拡張機能 Zephris Connector はChrome ウェブストアからインストールできます。インストール後に検証画面をリロードすると、ご自身の API キーで実データ検証が使えるようになります。

拡張機能は PC 版の Chrome / Edge でご利用いただけます。スマートフォンでは拡張機能をご利用いただけません。

Chrome ウェブストアで開く →

※ Chrome ウェブストアでは「Zephris J-Quants Bridge」という名前で公開しています。

※ Zephris Connector は JPX グループおよび株式会社 JPX 総研 (JPX Market Innovation & Research, Inc.) の関連会社・提携先・公式パートナーではありません。

STEP 03

API キーをブラウザに登録する

拡張機能をインストールしたら、ツールバーの Zephris アイコンからポップアップを 開き、J-Quants の API キーを入力します。「ブラウザを閉じても保存する」の チェックで、保存方法を切り替えられます。

  • チェックを入れる（永続保存）: ブラウザを閉じても次回その まま利用できます。同じ PC を使い続ける方向けです。
  • チェックを外す（セッション保存）: ブラウザを閉じると API キーは破棄されます。共有 PC や一時利用に向きます。

登録後は zephris.app の検証画面が API キー有効の状態になります。別の PC で 利用する場合は、各 PC で API キーを再登録してください (拡張機能は PC をまたぐ同期を行いません)。

実際の画面

API キーは、Connector のポップアップで登録します

Zephris Connector の API キー入力欄と保存設定
  • J-Quants API キーの入力欄
  • ブラウザを閉じたあとの保存方法
  • 入力内容を保存するボタン
PC 版 Chrome / Edge で開く、未設定状態のポップアップです。実際の API キーは含まれていません。API キーを入力し、利用する PC に合わせて保存方法を選び、「保存」を押します。
API キーは、Zephris サーバーに送信しない設計です。API キーは拡張機能のローカル領域で扱い、J-Quants API への問い合わせ時に、 あなたのブラウザから J-Quants へ送る構成を前提にしています。

接続状態の確認・診断や API キーの削除は、Web 側の API 接続設定 からも行えます（キーの入力・保存は拡張機能のポップアップのみ）。

あなたのデータについて

データの通り道を、見える形にします。

API キーと市場データが、どこからどこへ流れるか。「API キーは、Zephris サーバーに送信しない設計」を、図と 3 つの設計の要点で示します。

01

API キーは、あなたのブラウザに保存します

拡張機能のローカル領域 (chrome.storage.local) に保存。Zephris サーバーに 送信しない設計です。

02

市場データは、ブラウザから J-Quants へ取得します

必要な銘柄・期間の市場データは、あなたのブラウザから直接 J-Quants API に 問い合わせて取得する構成です。

03

検証条件や結果を、Zephris サーバーに保存しない設計です

パラメータ、累積リターン、シャープレシオ等の結果は、あなたのブラウザ内で 計算する構成を前提にしています。

技術メモ: 保存場所、削除方法、送信される情報

保存場所

API キーは Chrome 拡張機能のローカル領域 (chrome.storage.local) に保存されます。Web アプリ側の localStorage は使用しません。

保護方式と削除

保存時の保護方式、複数 PC での扱い、削除方法の詳細は、プライバシー ポリシーにまとめています。拡張機能の ポップアップ から削除するほか、拡張機能を アンインストールすると、保存されている情報は拡張機能のローカル保存領域 から削除されます。

送る情報 / 送らない情報

  • 送る: あなたのブラウザ → J-Quants へ、API キーとデータ要求 (銘柄・期間など)
  • 送る: あなたのブラウザ → Zephris Web 配信 (HTML/CSS/JS、フォント、画像) を取得するための通常のリクエスト
  • 送らない設計: API キー、検証条件、市場データ、検証結果を Zephris サーバーへ

市場データはバックテストの高速化のため、ブラウザ内の IndexedDB に キャッシュされる場合があります。これも Zephris サーバーに送らない構成です。

ご自身で確かめる方法

  • 検証を実行する前にブラウザの開発者ツール (F12) の Network タブを開いておくと、市場データ・API キー・戦略パラメータ・検証結果が Zephris 運営サーバーへ 送信されないこと (= 通信は J-Quants api.jquants.com への取得と、ページ配信 / ブラウザ内処理に限られること) を、ご自身の目で確認できます。
  • chrome://extensions から、拡張機能が通信できる接続先 (host_permissions = api.jquants.com のみ) を確認できます。
  • 拡張機能が接続を受け付けるサイトと通信先は、拡張の manifest.json のexternally_connectable / host_permissions に明記され、 ビルド検査でも固定されています (= コード上もオープンに監査できます)。

J-Quants API キーと取得した市場データは、Zephris のサーバー、analytics、広告サービス、LLM プロバイダーには送信されません。API キーは、あなたのブラウザ上の拡張機能から J-Quants API への認証にのみ使用されます。

詳細は プライバシーポリシー に記載しています。

ページ上部へ戻る

切り分け

よくあるつまずき

次のような状況になったとき、まず確認したい点をまとめました。検証手法や用語そのものに関する質問は、よくある質問 をご覧ください。

表示まず確認すること
API 未設定拡張機能に API キーが登録されているか。ポップアップ を開いて、登録状態と保存モードを確認します。
未認証API キーが正しいか、J-Quants 側の契約が有効か。
データが取得できない対象銘柄、期間、契約プラン、通信状態。期間や銘柄を絞って切り分けます。
上限に達した可能性J-Quants 側のレート制限やプラン条件。時間をおく、または取得範囲を見直します。

詳しい手順

「未認証」と表示されたときの確認順

API キーは拡張機能に届いているが、J-Quants 側での認証に失敗している状態です。 次の順で確認します。

  • ポップアップ で、キーの先頭と末尾に空白が混ざっていないか
  • J-Quants の管理画面で、キーが有効化されているか
  • 契約プランが、要求している銘柄・期間に対応しているか
拡張機能アイコンがツールバーに見つからないとき

Chrome ツールバー右側のパズルピース型アイコンから「拡張機能を管理」を開き、 Zephris Connector が有効か確認します。ピン留めしておくと、ツールバーに常時 表示されます。Chrome ウェブストアからインストール済みかも合わせて確認します。

検証結果が表示されない / 途中で止まるときの切り分け

多くは、対象銘柄の期間が契約プランの取得範囲外、または通信の一時的失敗です。 次のいずれかで切り分けます。

  • 検証期間を短く設定して、まず通るか確認する
  • 対象銘柄を 1 銘柄に絞って、認証と取得の経路を切り分ける
  • 少し時間をおいて再実行する

終了と削除

API キーの削除と、利用停止

いつでもやめられること。それも、安心して始めるための条件だと考えています。 やめ方は 3 通り。Web アプリ側の状態がどう変わるかも明示します。

CASE 01

API キーだけ削除する

拡張機能はそのまま残し、保存されている API キーだけを ポップアップ から削除します。再開時はキーを入れ直すだけで戻ります。

Web アプリの状態 「API キー未設定」になり、サンプルデータでの検証のみ可能になります。

CASE 02

拡張機能ごと削除する

Chrome の拡張機能管理画面から Zephris Connector をアンインストールします。API キーと拡張機能の設定は、拡張機能のローカル保存領域から削除されます。

Web アプリの状態 拡張機能未インストール扱いになり、API キー連携の導線が現れます。Web アプリそのものは引き続き閲覧できます。

CASE 03

すべて削除して新規状態に戻す

拡張機能をアンインストールし、ブラウザのサイトデータ削除で zephris.app に保存された Zephris のデータ（市場データのキャッシュ、検証履歴、保存した戦略やメモ、検証ケース、各種設定など）をまとめて消します。Zephris に紐づくブラウザ側の情報を整理したいときに。

Web アプリの状態 ブラウザに保存された Zephris のデータがすべて消え、新規ユーザーと同じ状態に戻ります。市場データのキャッシュだけをアプリ側で消した場合は、検証履歴や保存した戦略はブラウザ側に残ります。

※ API キーを削除しても、Zephris サーバーには元から保存していません（データの通り道）。ベータ登録情報、問い合わせ情報、アクセスログ等の扱いは、プライバシーポリシー に従います。

もう一度、確かめておきたいこと

検証は、判断の代わりではありません。

Zephris は、売買判断を代行しません。

過去データで確かめる場所を提供します。

判断は、あなた自身が下します。

ページ上部へ戻る