Companies, news & screening

Research companies, financials, capital flows, and analyst ratings. Search news and screen securities.

Commands at a glance

Command	Description
futu company <symbol>	Get company profiles, management, and operating data
futu financials <symbol>	Get financial statements, revenue breakdowns, and earnings data
futu research <symbol>	Get analyst consensus, research reports, and ratings
futu valuation [symbol]	Get valuation data
futu shareholders <symbol>	Get shareholder, institutional holding, and insider data
futu capital <symbol>	Get capital flows and distribution
futu short <symbol>	Get short-selling data
futu search [keyword]	Search news, community posts, or stock updates
futu economic-calendar [keyword]	Browse or search the economic calendar
futu corporate-actions <symbol>	Get dividends, splits, buybacks, and adjustment data
futu plate [symbol]	Get sectors, constituents, or sector membership
futu watchlist [symbol...]	View or manage watchlists
futu stock-screen	Screen stocks
futu warrant-screen	Screen warrants
futu option-screen	Screen options

Company and news queries

Some commands use --view or --type to select a data category:

# Get a company profile and financial statements
futu company HK.00700 --format json
futu financials HK.00700 --view statements --format json

# Get historical capital flows
futu capital HK.00700 --view history --period-type WEEK --format json

# Search news and community discussions
futu search AAPL --type news --format json
futu search AAPL --type community --format json

# Get analyst ratings
futu research HK.00700 --type rating --format json

Run a stock screen

Start with the CLI's built-in default conditions and retrieve up to 10 results:

futu stock-screen --limit 10 --format json

The following command spells out the same default condition so you can adapt and reuse it. Pass the JSON as a single argument. This example uses Bash / Zsh syntax:

futu stock-screen \
  --screen-queries '[{"simple_field_query":{"simple_field":1,"screen_value_list":[1]}}]' \
  --limit 10 --format json

The stock-screening API defines field numbers and enum values. Confirm which market or metric a number represents before creating custom conditions. This example only reproduces the CLI default.

Option	Purpose
--screen-queries	JSON array defining screening conditions
--retrieve-queries	JSON array selecting returned attributes
--sort / --sorts	JSON object / array defining sort rules
--limit	Page size; defaults to 20
--next-key	Pass the returned next-page cursor unchanged to continue

Check the returned items against the conditions, then inspect pagination. An empty result does not mean the command failed. When a next-page cursor is present, the current page is not the full list.

Screener help

futu stock-screen --help
futu warrant-screen --help
futu option-screen --help