Filter and sort every covered company (about 850) on published numbers

Filter and sort every covered company (about 850) on published numbers. All filters combine with AND; a company with no figure for a filtered number is left out, never counted as zero.

get/api/v1/screen

Request

  • Base URL: https://oqro.io
  • URL: https://oqro.io/api/v1/screen
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

sectorstring

GICS sector, for example Health Care or Energy.

min_market_valuenumber

Market value in US dollars (latest close times shares outstanding).

max_market_valuenumber

Market value in US dollars (latest close times shares outstanding).

min_change_12mnumber

Price change over 12 months, in percent (negative allowed).

max_change_12mnumber

Price change over 12 months, in percent (negative allowed).

min_vs_sp500_12mnumber

Percentage points ahead of (+) or behind (-) the S&P 500 over 12 months.

max_vs_sp500_12mnumber

Percentage points ahead of (+) or behind (-) the S&P 500 over 12 months.

within_pct_of_12m_highnumber

At most this many percent below the 12-month high.

at_least_pct_below_12m_highnumber

At least this many percent below the 12-month high.

min_insider_purchases_90dinteger

At least this many open-market insider purchases of $10K or more in the last 90 days.

min_congress_purchases_90dinteger

At least this many Congress purchases disclosed in the last 90 days.

min_fund_adds_180dinteger

At least this many 13F new or increased positions disclosed in the last 180 days.

has_federal_contracts_90dboolean

true: at least one federal contract award in the last 90 days.

profitableboolean

true: positive net income in the last fiscal year.

positive_free_cash_flowboolean

true: operating cash flow minus capital expenditure above zero in the last fiscal year (not returned for banks and insurers).

net_cashboolean

true: more cash than debt at the latest report (not for banks and insurers).

min_days_to_covernumber

Minimum FINRA short-interest days to cover.

sort_bystring

One of market_value, change_12m, vs_sp500_12m, change_90d, vs_12m_high, insider_purchase_value_90d, insider_purchases_90d, congress_purchases_90d, fund_adds_180d, revenue, net_margin, free_cash_flow, days_to_cover, ticker. Default market_value.

directionstring

desc (default) or asc.

limitinteger

Rows per page, 1 to 100. Default 25.

cursorstring

The pagination.next_cursor of the previous page, unchanged. Keep the same filters.

Response

JSON: { data, pagination?, meta? }. Every row links its official source.

dataunknown required
paginationobject
metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.