Raw schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"maxLength": 40,
"description": "GICS sector, e.g. 'Information Technology', 'Health Care', 'Financials', 'Energy'."
},
"min_market_value": {
"type": "number",
"minimum": 0,
"description": "Minimum market value in USD (latest close x shares outstanding on the filing cover)."
},
"max_market_value": {
"type": "number",
"minimum": 0,
"description": "Maximum market value in USD."
},
"min_change_12m": {
"type": "number",
"description": "Minimum price change over 12 months, in percent (negative allowed)."
},
"max_change_12m": {
"type": "number",
"description": "Maximum price change over 12 months, in percent."
},
"min_vs_sp500_12m": {
"type": "number",
"description": "Minimum points ahead of (+) or behind (-) the S&P 500 over 12 months."
},
"max_vs_sp500_12m": {
"type": "number",
"description": "Maximum points ahead of (+) or behind (-) the S&P 500 over 12 months."
},
"within_pct_of_12m_high": {
"type": "number",
"minimum": 0,
"description": "At most this many percent below the 12-month high (5 = within 5% of the high)."
},
"at_least_pct_below_12m_high": {
"type": "number",
"minimum": 0,
"description": "At least this many percent below the 12-month high (30 = down 30% or more from the high)."
},
"min_insider_purchases_90d": {
"type": "integer",
"minimum": 1,
"description": "At least this many open-market insider purchases of $10K or more in the last 90 days."
},
"min_congress_purchases_90d": {
"type": "integer",
"minimum": 1,
"description": "At least this many Congress purchases disclosed in the last 90 days."
},
"min_fund_adds_180d": {
"type": "integer",
"minimum": 1,
"description": "At least this many 13F new or increased fund positions disclosed in the last 180 days."
},
"has_federal_contracts_90d": {
"type": "boolean",
"description": "True: at least one federal contract award in the last 90 days."
},
"profitable": {
"type": "boolean",
"description": "True: positive net income in the last fiscal year."
},
"positive_free_cash_flow": {
"type": "boolean",
"description": "True: operating cash flow minus capex above zero in the last fiscal year (not for banks and insurers)."
},
"net_cash": {
"type": "boolean",
"description": "True: more cash than debt at the latest report (not for banks and insurers)."
},
"min_days_to_cover": {
"type": "number",
"minimum": 0,
"description": "Minimum FINRA short-interest days to cover."
},
"sort_by": {
"type": "string",
"enum": [
"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",
"description": "Field to sort by."
},
"direction": {
"type": "string",
"enum": [
"asc",
"desc"
],
"default": "desc"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "Companies to return (max 50)."
}
},
"additionalProperties": false
}