The Canadian Stock Screener API allows to filter and identify companies using a wide range of financial, valuation, dividend, profitability, and market metrics. This endpoint powers advanced equity screening experiences, enabling users to programmatically search the Canadian equity universe based on custom investment criteria.

---

What This API Enables

Ideal For

The Canadian Stock Screener API is designed to power a wide range of financial and investment applications.

📊 Investment Platforms

Enable users to discover opportunities across the Canadian market using customizable financial filters and screening tools.

📁 Portfolio Management Tools

Allow portfolio managers and advisors to identify companies that match specific investment mandates or portfolio strategies.

🔎 Stock Research Applications

Provide analysts and retail investors with powerful research capabilities based on valuation, profitability, dividend, and market performance metrics.

🤖 Quantitative Research Systems

Integrate financial metrics into systematic strategies, algorithmic research, and quantitative stock selection models.

💼 Wealth Management Dashboards

Support advisors and wealth platforms with dynamic equity screening tools to identify investment candidates for client portfolios.

🎓 Financial Education Platforms

Help students and investors learn about financial metrics and investment strategies through interactive screening experiences.

---

Endpoint

GET /ScreenerGetByCriterias

The endpoint returns stocks that match the filters provided in the criteria parameter.

---

How Screening Works

The API uses a parameter called criteria.

This parameter defines filters applied to the stock universe.

Each filter contains four elements:

LogicalOperator : Field : Operator : Value

Multiple filters can be combined to build sophisticated screens.

Example:

and:marketCap:>:1000000000;and:returnOnEquity:>:10;and:divYield:>:3

This query finds companies with:

• Market capitalization greater than $1B
• Return on equity greater than 10%
• Dividend yield greater than 3%

---

Criteria Structure

{LogicalOperator}:{Field}:{Operator}:{Value}

Multiple filters are separated using a semicolon ;.

Example:

and:marketCap:>:1000000000;
and:returnOnEquity:>:10;
and:divYield:>:3

---

Logical Operators

Logical operators determine how filters interact.

Example:

and:marketCap:>:1000000000;and:returnOnEquity:>:10

---

Comparison Operators

---

Value Formats

Single Value

and:divYield:>:3

Dividend yield greater than 3%.

---

Range

and:high52Week:between:74,149

52-week high between 74 and 149.

---

Multiple Values

and:exchange:in:TSX,TSXV

Companies listed on TSX or TSXV.

---

Example Investment Screens

Below are examples of real investment workflows enabled by this API.

---

Dividend Income Stocks

Identify companies generating strong dividend income.

and:divYield:>:4;and:marketCap:>:500000000

Filters:

• Dividend yield above 4%
• Market cap above $500M

---

High Quality Companies

Screen for financially strong companies.

and:returnOnEquity:>:15;and:debtToEquity:<:1

Filters:

• ROE greater than 15%
• Debt-to-equity below 1

---

Value Opportunities

Find companies trading at attractive valuations.

and:priceToEarRatio:<:20;and:priceToBook:<:2

Filters:

• P/E ratio below 20
• Price-to-book below 2

---

Growth Companies

Identify companies with strong revenue generation.

and:totalRevenueTtm:>:1000000000;and:netProfitMargin:>:10

Filters:

• Revenue above $1B
• Net profit margin above 10%

---

Supported Screening Fields

The API provides a wide range of financial metrics to build sophisticated screening strategies.

---

Company Identification

---

Market Metrics

---

Company Size

---

Profitability Metrics

---

Valuation Metrics

---

Per Share Metrics

---

Financial Strength

---

Dividends

---

Revenue and Earnings

---

Best Practices

Combine multiple filters

and:marketCap:>:1000000000;and:returnOnEquity:>:10

---

Use ranges for flexible screening

and:high52Week:between:50,100

---

Filter multiple exchanges or sectors

and:exchange:in:TSX,TSXV

---

Example Complete Query

criteria=and:marketCap:>:1000000000;and:returnOnEquity:>:10;and:divYield:>:3

This query returns companies that:

• Have a market cap above $1B
• Generate ROE above 10%
• Pay dividends above 3%

---

Build Powerful Investment Screening Tools

The Canadian Stock Screener API enables developers, fintech platforms, and research teams to discover and analyze Canadian publicly traded companies using financial and market data.

By combining valuation ratios, profitability indicators, dividend metrics, financial health ratios, and market performance signals, applications can create highly customizable stock screens tailored to different investment strategies.

This makes it possible to build advanced stock screeners, investment research platforms, portfolio analytics dashboards, and financial discovery tools focused on the Canadian equity market.

But screening companies is only one part of the data available through the StockGuide Financials API.

---

Explore the Full StockGuide Financials API

The StockGuide Financials API provides access to multiple datasets covering Canadian publicly traded companies, enabling developers and financial organizations to build complete investment research and analytics platforms.

Available resources include:

Together, these endpoints allow organizations to integrate comprehensive Canadian equity data — from financial fundamentals and statements to peer analysis and advanced stock screening — directly into their applications.

---