CLI

在终端中使用 fcontext 查询 Financial Context 市场数据、管理登录，并为脚本或 agent 输出 JSON。 CLI 默认连接 Financial Context：

https://openapi.fcontext.com

命令会调用 /api/market-data/* 下的只读市场数据接口。当前 CLI 聚焦美股数据：标的必须使用 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 登录。该方式适用于本地终端、SSH session 和 headless server，因为 CLI 会打印授权 URL 和下一条需要执行的命令。

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

# 日 K 线
fcontext kline AAPL.US --period day --count 100

# 按日期范围查询历史 K 线
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

直接访问 Endpoint

当某个受支持的只读 endpoint 还没有专用命令时，可以使用 api get：

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

CLI 会在发送请求前拒绝绝对 URL、streaming endpoint、非美股 market filter，以及不支持的账户或交易路径。

面向 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` 重新登录。
非美股 symbol 被拒绝	使用 `AAPL.US` 这类 symbol；CLI 有意不暴露非美股市场。
需要请求详情	添加 `--verbose`，将请求 URL 和耗时打印到 stderr。

首页

开始使用

API 指南

集成

API 参考

命令基础

安装

认证

OAuth 2.0 登录

Authorization Code

登出

认证状态

检查

更新

首批命令

市场数据

公司数据

新闻与事件

交易活动

选股器

直接访问 Endpoint

面向 Agent 的输出

故障排查

​命令基础

​安装

​认证

​OAuth 2.0 登录

​Authorization Code

​登出

​认证状态

​检查

​更新

​首批命令

​市场数据

​公司数据

​新闻与事件

​交易活动

​选股器

​直接访问 Endpoint

​面向 Agent 的输出

​故障排查

命令基础

安装

认证

OAuth 2.0 登录

Authorization Code

登出

认证状态

检查

更新

首批命令

市场数据

公司数据

新闻与事件

交易活动

选股器

直接访问 Endpoint

面向 Agent 的输出

故障排查