CLI

ターミナルから fcontext を使用して Financial Context 市場データを照会し、サインインを管理し、スクリプトや agent 向けに JSON を出力します。 CLI はデフォルトで Financial Context に接続します。

https://openapi.fcontext.com

コマンドは /api/market-data/* 配下の読み取り専用市場データエンドポイントを呼び出します。現在の CLI は US 株式データにフォーカスしており、シンボルは CODE.US 形式、market フィルターは US である必要があります。

コマンドの基本

どちらのコマンド名も使用できます。fctx は fcontext の短いエイリアスで、同じサブコマンド、flag、出力形式、schema をサポートします。

fcontext quote AAPL.US MSFT.US --format json
fctx quote AAPL.US MSFT.US --format json

インストール

macOS (Homebrew)
Linux / macOS (Script)
Windows (Scoop)
Windows (PowerShell)

Aitaport tap から fcontext-cli cask をインストールします。

brew install --cask aitaport/tap/fcontext-cli

最新 release の shell インストーラーを使用します。

curl -sSL https://github.com/aitaport/fcontext-cli/releases/latest/download/install.sh | sh

最新 release の fcontext.json Scoop manifest からインストールします。

scoop install https://github.com/aitaport/fcontext-cli/releases/latest/download/fcontext.json

最新 release の PowerShell インストーラーを使用します。

iwr https://github.com/aitaport/fcontext-cli/releases/latest/download/install.ps1 | iex

Release artifact は fcontext-cli-* パッケージ名を使用します。 fcontext-cli-darwin-amd64.tar.gz、fcontext-cli-darwin-arm64.tar.gz、 fcontext-cli-linux-musl-amd64.tar.gz、fcontext-cli-linux-musl-arm64.tar.gz、 fcontext-cli-windows-amd64.zip が含まれます。shell と PowerShell のインストーラーは対応するアーカイブをダウンロードし、 .sha256 checksum を検証して、fcontext と fctx の両方をインストールします。古い /fcontext/fcontext-terminal/* ホスト済みインストーラー URL は、互換性のために最新 release へリダイレクトまたはミラーされます。

認証

CLI 認証を管理します。サインイン、サインアウト、ローカル token 状態の確認ができます。

OAuth 2.0 ログイン

OAuth 2.0 authorization-code flow でサインインします。CLI が認可 URL と次に実行するコマンドを表示するため、ローカルターミナル、SSH session、headless server で利用できます。

fcontext auth login

表示された認可 URL を任意のブラウザで開き、認可を完了して返された code をコピーし、次のように引き換えます。

fcontext auth login --auth-code YOUR_CODE

CLI は token をローカルの fcontext 設定ディレクトリに oauth-token.json として保存します。以降のコマンドはその token を自動的に再利用します。

Authorization Code

現在のマシンでブラウザを使えない場合は、Financial Context Connect から一回限りの authorization code を生成して直接引き換えます。

fcontext auth login --auth-code YOUR_CODE

ログアウト

ローカルに保存された OAuth token を削除します。次の認証済みコマンドでは再ログインが必要です。

fcontext auth logout

認証ステータス

現在の base URL とサインイン状態を確認します。

fcontext auth status
fcontext auth status --format json

チェック

アクティブな市場セッションに依存せず、サインインと Financial Context API 接続性を検証します。レポートには endpoint ステータスとレイテンシが含まれます。

fcontext check
fcontext check --format json
fctx check --format json

更新

公式インストーラースクリプトをダウンロードして実行し、現在の CLI binary を最新リリースに置き換えます。

fcontext update
fctx update

最初のコマンド

# リアルタイムクォート
fcontext quote AAPL.US MSFT.US

# 短いエイリアス
fctx quote AAPL.US MSFT.US

# スクリプトと agent 向け JSON 出力
fcontext quote AAPL.US MSFT.US --format json

# 静的な証券情報
fcontext static AAPL.US MSFT.US

# 日足ローソク足
fcontext kline AAPL.US --period day --count 100

# 日付範囲で過去ローソク足を取得
fcontext kline history AAPL.US --start 2024-01-01 --end 2024-12-31

市場データ

fcontext market-status
fcontext top-movers --market US --sort hot --count 20
fcontext market-temp US
fcontext market-temp US --history --start 2024-01-01 --end 2024-12-31
fcontext trading session
fcontext trading days US --start 2026-01-01 --end 2026-01-31
fcontext security-list US

fear-greed を使用すると Fear & Greed Index を確認できます。これは投資家のリスク選好を extreme fear から extreme greed までの尺度で要約する市場センチメント指標です。

fcontext fear-greed
fcontext fear-greed --history-count 90 --indicator-history-count 10 --format json

企業データ

fcontext company AAPL.US
fcontext fundamental-compare AAPL.US
fcontext compare AAPL.US MSFT.US NVDA.US --currency USD
fcontext consensus AAPL.US
fcontext dividend AAPL.US
fcontext forecast-eps AAPL.US
fcontext insider-trades AAPL.US --count 20
fcontext institution-rating AAPL.US
fcontext institution-rating detail AAPL.US
fcontext operating AAPL.US
fcontext shareholder AAPL.US
fcontext shareholder AAPL.US --top --periods 4
fcontext valuation AAPL.US
fcontext valuation AAPL.US --history

ニュースとイベント

fcontext news AAPL.US
fcontext filing AAPL.US
fcontext topic AAPL.US
fcontext finance-calendar report --market US
fcontext finance-calendar dividend --market US

取引アクティビティ

fcontext trades AAPL.US --count 50
fcontext trade-stats AAPL.US
fcontext short-positions AAPL.US
fcontext short-trades AAPL.US

スクリーナー

fcontext screener strategies --market US
fcontext screener mine --market US
fcontext screener strategy 19
fcontext screener run 19 --count 20
fcontext screener filter pettm:10:50 roe:5: --market US
fcontext screener indicators

エンドポイントへの直接アクセス

専用コマンドがまだないサポート済みの読み取り専用エンドポイントには、api get を使用します。

fcontext api get /api/market-data/market/status --format json

CLI はリクエスト送信前に、絶対 URL、streaming endpoint、US 以外の market フィルター、サポートされていないアカウントまたは取引パスを拒否します。

Agent 向け出力

すべてのコマンドは JSON 出力をサポートします。

fcontext company AAPL.US --format json

--schema で機械可読なレスポンス schema を出力します。

fcontext company --schema
fcontext quote --schema
fctx quote --schema

shell completions を生成します。

fcontext completion zsh > ~/.zfunc/_fcontext
fcontext completion bash > ~/.local/share/bash-completion/completions/fcontext
fcontext completion fish > ~/.config/fish/completions/fcontext.fish

トラブルシューティング

問題	確認すること
`Missing fcontext credentials`	`fcontext auth login` を実行するか、`fcontext auth login --auth-code YOUR_CODE` で authorization code を引き換えます。
`fcontext API error (401)`	`fcontext auth status` を実行し、ローカル token がない、または期限切れの場合は `fcontext auth login` で再度サインインします。
US 以外の symbol が拒否される	`AAPL.US` のような symbol を使用します。CLI は意図的に US 以外の市場を公開していません。
リクエスト詳細が必要	`--verbose` を追加すると、リクエスト URL と経過時間が stderr に出力されます。

ホーム

はじめる

API ガイド

インテグレーション

API リファレンス

コマンドの基本

インストール

認証

OAuth 2.0 ログイン

Authorization Code

ログアウト

認証ステータス

チェック

更新

最初のコマンド

市場データ

企業データ

ニュースとイベント

取引アクティビティ

スクリーナー

エンドポイントへの直接アクセス

Agent 向け出力

トラブルシューティング

​コマンドの基本

​インストール

​認証

​OAuth 2.0 ログイン

​Authorization Code

​ログアウト

​認証ステータス

​チェック

​更新

​最初のコマンド

​市場データ

​企業データ

​ニュースとイベント

​取引アクティビティ

​スクリーナー

​エンドポイントへの直接アクセス

​Agent 向け出力

​トラブルシューティング

コマンドの基本

インストール

認証

OAuth 2.0 ログイン

Authorization Code

ログアウト

認証ステータス

チェック

更新

最初のコマンド

市場データ

企業データ

ニュースとイベント

取引アクティビティ

スクリーナー

エンドポイントへの直接アクセス

Agent 向け出力

トラブルシューティング