Get Technical Metrics Screener

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/screener/technical-metrics \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "date": "2024-01-15",
      "metric": "PE_RATIO",
      "snapshot_time": 1705276800,
      "symbol": "AAPL",
      "value": 28.5
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Stock

Get Technical Metrics Screener

OpenAPI JSON Spec Retrieve stocks filtered by technical metrics at a specific snapshot time. Returns stocks matching the specified metric type and value range.

Overview: This endpoint filters stocks based on technical analysis metrics from the market_metrics_1d, market_metrics_1w, or market_metrics_1m tables. The snapshot parameter is a Unix timestamp (seconds) that will be used directly for querying data.

Price Change Metrics (9 metrics):

PRICE_CHANGE_1D: Price change over 1 day (percentage)
PRICE_CHANGE_1W: Price change over 1 week (percentage)
PRICE_CHANGE_1M: Price change over 1 month (percentage)
PRICE_CHANGE_3M: Price change over 3 months (percentage)
PRICE_CHANGE_6M: Price change over 6 months (percentage)
PRICE_CHANGE_YTD: Price change year-to-date (percentage)
PRICE_CHANGE_1Y: Price change over 1 year (percentage)
PRICE_CHANGE_3Y: Price change over 3 years (percentage)
PRICE_CHANGE_5Y: Price change over 5 years (percentage)

Volume Metrics (3 metrics):

SHARES_VOLUME: Trading volume in shares
DOLLAR_VOLUME: Trading volume in dollars (price × volume)
AVERAGE_DAILY_DOLLAR_VOLUME: Average daily dollar volume

Moving Averages - Simple Moving Average (MA) (6 metrics):

MA_5: 5-day Simple Moving Average
MA_10: 10-day Simple Moving Average
MA_20: 20-day Simple Moving Average
MA_60: 60-day Simple Moving Average
MA_120: 120-day Simple Moving Average
MA_200: 200-day Simple Moving Average

Moving Averages - Exponential Moving Average (EMA) (6 metrics):

EMA_5: 5-day Exponential Moving Average
EMA_10: 10-day Exponential Moving Average
EMA_20: 20-day Exponential Moving Average
EMA_60: 60-day Exponential Moving Average
EMA_120: 120-day Exponential Moving Average
EMA_200: 200-day Exponential Moving Average

Momentum Indicators (1 metric):

RSI_14: Relative Strength Index (14-period) - Momentum oscillator that measures speed and magnitude of price changes (typically ranges from 0 to 100)

MACD (Moving Average Convergence Divergence) Components (3 metrics):

MACD_DIF: MACD Line (DIF) - Difference between 12-day EMA and 26-day EMA
MACD_DEA: Signal Line (DEA) - 9-day EMA of the MACD line
MACD_HIST: MACD Histogram - Difference between MACD line and signal line

Bollinger Bands Components (3 metrics):

BOLLINGER_UPPER: Upper Bollinger Band - Upper band of Bollinger Bands (20-day MA + 2 standard deviations)
BOLLINGER_MID: Middle Bollinger Band - 20-day Simple Moving Average
BOLLINGER_LOWER: Lower Bollinger Band - Lower band of Bollinger Bands (20-day MA - 2 standard deviations)

Other Technical Indicators (5 metrics):

VWAP_DAY: Volume Weighted Average Price (Day) - Average price weighted by volume for the trading day
BETA: Beta - Measure of stock’s volatility relative to the market (typically S&P 500). Beta of 1 means stock moves with market
VOLATILITY_20: Volatility (20-period) - Standard deviation of returns over 20 periods (annualized)
VOLATILITY_60: Volatility (60-period) - Standard deviation of returns over 60 periods (annualized)
VOLATILITY_90: Volatility (90-period) - Standard deviation of returns over 90 periods (annualized)

Filtering:

Use range_min to filter for stocks where the metric value is greater than or equal to the minimum
Use range_max to filter for stocks where the metric value is less than or equal to the maximum
Both filters can be used together to create a range
If neither filter is provided, all stocks matching the metric type will be returned

Response Format: Returns an array of stocks with their symbol, snapshot time (Unix timestamp seconds, UTC), metric type, and metric value. ETF inclusion: Liquid ETFs (30-day average daily dollar volume ≥ $10M, ~800 ETFs) are included in results across all 36 technical metrics.

GET

stocks

screener

technical-metrics

Get Technical Metrics Screener

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/screener/technical-metrics \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "date": "2024-01-15",
      "metric": "PE_RATIO",
      "snapshot_time": 1705276800,
      "symbol": "AAPL",
      "value": 28.5
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key

string

header

required

API Key authentication. Example: "your-api-key-here"

Query Parameters

snapshot

integer

required

Snapshot time (Unix timestamp in seconds, used directly for querying)

metric_type

string

required

Metric type. Valid values: PRICE_CHANGE_1D, PRICE_CHANGE_1W, PRICE_CHANGE_1M, PRICE_CHANGE_3M, PRICE_CHANGE_6M, PRICE_CHANGE_YTD, PRICE_CHANGE_1Y, PRICE_CHANGE_3Y, PRICE_CHANGE_5Y, SHARES_VOLUME, DOLLAR_VOLUME, AVERAGE_DAILY_DOLLAR_VOLUME, MA_5, MA_10, MA_20, MA_60, MA_120, MA_200, EMA_5, EMA_10, EMA_20, EMA_60, EMA_120, EMA_200, RSI_14, MACD_DIF, MACD_DEA, MACD_HIST, BOLLINGER_UPPER, BOLLINGER_MID, BOLLINGER_LOWER, VWAP_DAY, BETA, VOLATILITY_20, VOLATILITY_60, VOLATILITY_90

range_min

number<float64>

Minimum value filter (optional). Returns only stocks where metric value >= range_min

range_max

number<float64>

Maximum value filter (optional). Returns only stocks where metric value <= range_max

order_by

string

Sort order (optional). Valid values: ASC (ascending), DESC (descending). Defaults to DESC

symbol_type

enum<string>

Asset type filter. Valid values: stock (CS/ADRC), etf. Optional, defaults to stock.

Available options:

stock,

etf

Response

Successfully retrieved technical metrics screener data

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get Financial Metrics Screener Time Range Get Technical Metrics Screener Time Range