Get Technical Metrics Screener Time Range

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

{
  "data": [
    {
      "date": "2024-01-01",
      "items": [
        {
          "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 Time Range

OpenAPI JSON Spec Retrieve stocks filtered by technical metrics over a time range. Returns stocks matching the specified metric type and value range, grouped by date.

Overview: This endpoint filters stocks based on technical analysis metrics from the market_metrics_1d, market_metrics_1w, or market_metrics_1m tables over a specified time range. Results are grouped by date (YYYY-MM-DD format).

Technical Metrics: Same as the snapshot endpoint - supports all technical metric types (PRICE_CHANGE_1W, MA_5, RSI_14, BETA, etc.)

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

Limit Parameter:

Use limit to limit the maximum number of results returned per day (optional, defaults to no limit)
This is useful for pagination or when you only need the top N results per day

Response Format: Returns an array of date-grouped data items. Each item contains a date (YYYY-MM-DD format) and an array of stocks with their symbol, snapshot time (Unix timestamp seconds, UTC), metric type, and metric value for that date. ETF inclusion: Liquid ETFs (30-day average daily dollar volume ≥ $10M, ~800 ETFs) are included in results across all 36 technical metrics.

GET

/

v1

/

stocks

/

screener

/

technical-metrics

/

timerange

Get Technical Metrics Screener Time Range

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

{
  "data": [
    {
      "date": "2024-01-01",
      "items": [
        {
          "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

start_time

integer

required

Start time (Unix timestamp in seconds, UTC)

end_time

integer

required

End time (Unix timestamp in seconds, UTC)

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

limit

integer

Maximum number of results per day (optional, defaults to no limit)

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 time range data

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get Technical Metrics Screener Get SEC Earnings Release publication date