CLI

Use fcontext from your terminal to query Financial Context market data, manage sign-in, and produce JSON output for scripts or agents. The CLI talks to Financial Context by default:

https://openapi.fcontext.com

Commands call read-only market-data endpoints under /api/market-data/*. The current CLI focuses on US stock data: symbols must use the CODE.US format, and market filters must be US.

Command Basics

Use either command name. fctx is the short alias for fcontext and supports the same subcommands, flags, output formats, and schemas.

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

Install

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

Install the fcontext-cli cask from the Aitaport tap:

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

Install with the latest release shell installer:

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

Install from the latest release fcontext.json Scoop manifest:

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

Install with the latest release PowerShell installer:

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

Release artifacts use the fcontext-cli-* package names, including 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, and fcontext-cli-windows-amd64.zip. The shell and PowerShell installers download the matching archive, verify its .sha256 checksum, and install both fcontext and fctx. Legacy hosted /fcontext/fcontext-terminal/* installer URLs continue to redirect or mirror the latest release for compatibility.

Authenticate

Manage CLI authentication: sign in, sign out, and inspect the local token status. Use the OAuth 2.0 authorization-code flow to sign in. This works in local terminals, SSH sessions, and headless servers because the CLI prints the authorization URL and the next command to run.

fcontext auth login

Open the printed authorization URL in any browser, complete authorization, then copy the returned code and redeem it:

fcontext auth login --auth-code YOUR_CODE

The CLI stores the token as oauth-token.json in the local fcontext config directory. Later commands reuse that token automatically.

Authorization Code

If no browser is available on the current machine, generate a one-time authorization code from Financial Context Connect and redeem it directly:

fcontext auth login --auth-code YOUR_CODE

Auth Logout

Clear the locally stored OAuth token. The next authenticated command will require a new login.

fcontext auth logout

Auth Status

Inspect the current base URL and sign-in status.

fcontext auth status
fcontext auth status --format json

Check

Validate sign-in and Financial Context API connectivity without relying on an active market session. The report includes endpoint status and latency.

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

Update

Download and run the official installer script to replace the current CLI binary with the latest release.

fcontext update
fctx update

First Commands

# Realtime quotes
fcontext quote AAPL.US MSFT.US

# Short alias
fctx quote AAPL.US MSFT.US

# JSON output for scripts and agents
fcontext quote AAPL.US MSFT.US --format json

# Static instrument information
fcontext static AAPL.US MSFT.US

# Daily candles
fcontext kline AAPL.US --period day --count 100

# Historical candles by date range
fcontext kline history AAPL.US --start 2024-01-01 --end 2024-12-31

Market Data

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

Use fear-greed to inspect the Fear & Greed Index, a market-sentiment indicator that summarizes investor appetite for risk on a scale from extreme fear to extreme greed:

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

Company Data

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

News And Events

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

Trading Activity

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

Screeners

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

Direct Endpoint Access

Use api get when you need a supported read-only endpoint before a dedicated command exists:

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

The CLI rejects absolute URLs, streaming endpoints, non-US market filters, and unsupported account or trading paths before sending a request.

Output For Agents

Every command supports JSON output:

fcontext company AAPL.US --format json

Use --schema to print a machine-readable response schema:

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

Generate shell completions:

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

Troubleshooting

Problem	What to check
`Missing fcontext credentials`	Run `fcontext auth login`, or redeem an authorization code with `fcontext auth login --auth-code YOUR_CODE`.
`fcontext API error (401)`	Run `fcontext auth status`, then sign in again with `fcontext auth login` if the local token is missing or expired.
Non-US symbol rejected	Use symbols such as `AAPL.US`; non-US markets are intentionally not exposed by the CLI.
Need request details	Add `--verbose` to print the request URL and elapsed time to stderr.

Home

Get Started

API Guides

Integrations

API Reference

Command Basics

Install

Authenticate

Authorization Code

Auth Logout

Auth Status

Check

Update

First Commands

Market Data

Company Data

News And Events

Trading Activity

Screeners

Direct Endpoint Access

Output For Agents

Troubleshooting

​Command Basics

​Install

​Authenticate

​OAuth 2.0 Login

​Authorization Code

​Auth Logout

​Auth Status

​Check

​Update

​First Commands

​Market Data

​Company Data

​News And Events

​Trading Activity

​Screeners

​Direct Endpoint Access

​Output For Agents

​Troubleshooting

Command Basics

Install

Authenticate

OAuth 2.0 Login

Authorization Code

Auth Logout

Auth Status

Check

Update

First Commands

Market Data

Company Data

News And Events

Trading Activity

Screeners

Direct Endpoint Access

Output For Agents

Troubleshooting