GET /v1/screener Premium (2×)

Market Screener

Scan all supported symbols and return those matching your indicator criteria. Find oversold markets, trending pairs, volatility breakouts, and more in a single call.

Parameters

Parameter	Type	Required	Description
indicator	string	Yes	Indicator to screen (e.g. RSI_14, MACD_main, ADX)
condition	string	Yes	Comparison: `gt`, `lt`, `gte`, `lte`, `eq`, `cross_above`, `cross_below`
value	number	Yes	Threshold value to compare against
timeframe	string	Yes	Timeframe: M1–D1
symbols	string	No	Comma-separated list to limit scan (default: all symbols)
offset	integer	No	Number of results to skip. Default: 0
limit	integer	No	Maximum matches to return (1-200). Default: 50

Example Request

cURL

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://tickatlas.com/v1/screener?indicator=RSI_14&condition=lt&value=30&timeframe=H1&offset=0&limit=50"

Success Response

200 OK

{
  "success": true,
  "screener": {
    "indicator": "RSI_14",
    "condition": "lt",
    "value": 30,
    "timeframe": "H1"
  },
  "matches": [
    {
      "symbol": "GBPUSD",
      "indicator_value": 24.31,
      "signal": "oversold",
      "price": 1.26432
    },
    {
      "symbol": "AUDUSD",
      "indicator_value": 28.76,
      "signal": "oversold",
      "price": 0.65218
    }
  ],
  "total_scanned": 50,
  "total_matches": 2,
  "timestamp": "2026-03-21T14:00:00Z",
  "pagination": {
    "offset": 0,
    "limit": 50,
    "total": 2,
    "has_more": false
  }
}

Use Cases

Find Oversold Pairs

Screen for RSI < 30 to find potential reversal candidates

Trend Detection

Screen for ADX > 25 to find symbols with strong trends

Volatility Breakout

Screen for BB_Width > threshold to find expanding markets

MACD Crossover

Use cross_above condition to find fresh bullish signals