API Reference

V1

Screener

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Replace Screener

ScreenerReplaceScreenerResponse v1().screener().replaceScreener(ScreenerReplaceScreenerParamsparams = ScreenerReplaceScreenerParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

PUT/v1/saved-screeners/{screener_id}

Update a saved screener configuration.

Replaces the screener configuration for the authenticated user. If name is null, the existing name is preserved.

ParametersExpand Collapse

ScreenerReplaceScreenerParams params

Optional<String> screenerId

Optional<List<FieldRef>> columns

Structured field references to include when running this screener

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

DeprecatedOptional<List<FieldRef>> fieldFilter

Deprecated: use columns instead. Ignored when columns is provided.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<List<SearchFilter>> filters

Structured search filter criteria

FieldRef left

The field to filter on.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<FilterOpSpec> op

The operator and optional arguments. Omit together with right for an unenabled filter.

FilterOperator name

The operator to apply.

One of the following:

LESS_THAN("LESS_THAN")

LESS_OR_EQUAL("LESS_OR_EQUAL")

GREATER_THAN("GREATER_THAN")

GREATER_OR_EQUAL("GREATER_OR_EQUAL")

EQUAL("EQUAL")

BETWEEN("BETWEEN")

NOT_BETWEEN("NOT_BETWEEN")

ONE_OF("ONE_OF")

REGEX("REGEX")

BEGINS_WITH("BEGINS_WITH")

ENDS_WITH("ENDS_WITH")

CONTAINS("CONTAINS")

IS_NULL("IS_NULL")

IS_NOT_NULL("IS_NOT_NULL")

Optional<List<OperatorArg>> args

Optional arguments that modify operator behavior.

One of the following:

LEFT_INCLUSIVE("LEFT_INCLUSIVE")

RIGHT_INCLUSIVE("RIGHT_INCLUSIVE")

LEFT_EXCLUSIVE("LEFT_EXCLUSIVE")

RIGHT_EXCLUSIVE("RIGHT_EXCLUSIVE")

CASE_INSENSITIVE("CASE_INSENSITIVE")

Optional<List<FilterValue>> right

The value(s) to compare against. Omit together with op for an unenabled filter.

Optional<Value> value

One of the following:

double

String

Optional<Variable> variable

A variable reference.

String name

The variable name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<Modifier> modifier

Optional arithmetic modifier.

List<Arg> args

One of the following:

double

String

ModifierOp name

The modifier operation.

One of the following:

ADD("ADD")

SUBTRACT("SUBTRACT")

Optional<FieldPeriod> period

Optional reporting period.

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<String> name

The name for this screener configuration

Optional<List<SortSpec>> sorts

Multi-field sort specifications

FieldRef field

The field to sort by.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<SortDirection> direction

Sort direction (defaults to DESC).

One of the following:

ASC("ASC")

DESC("DESC")

ReturnsExpand Collapse

class ScreenerReplaceScreenerResponse:

ScreenerEntry data

A saved screener configuration entry

String id

LocalDateTime createdAt

List<SearchFilter> filters

FieldRef left

The field to filter on.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<FilterOpSpec> op

The operator and optional arguments. Omit together with right for an unenabled filter.

FilterOperator name

The operator to apply.

One of the following:

LESS_THAN("LESS_THAN")

LESS_OR_EQUAL("LESS_OR_EQUAL")

GREATER_THAN("GREATER_THAN")

GREATER_OR_EQUAL("GREATER_OR_EQUAL")

EQUAL("EQUAL")

BETWEEN("BETWEEN")

NOT_BETWEEN("NOT_BETWEEN")

ONE_OF("ONE_OF")

REGEX("REGEX")

BEGINS_WITH("BEGINS_WITH")

ENDS_WITH("ENDS_WITH")

CONTAINS("CONTAINS")

IS_NULL("IS_NULL")

IS_NOT_NULL("IS_NOT_NULL")

Optional<List<OperatorArg>> args

Optional arguments that modify operator behavior.

One of the following:

LEFT_INCLUSIVE("LEFT_INCLUSIVE")

RIGHT_INCLUSIVE("RIGHT_INCLUSIVE")

LEFT_EXCLUSIVE("LEFT_EXCLUSIVE")

RIGHT_EXCLUSIVE("RIGHT_EXCLUSIVE")

CASE_INSENSITIVE("CASE_INSENSITIVE")

Optional<List<FilterValue>> right

The value(s) to compare against. Omit together with op for an unenabled filter.

Optional<Value> value

One of the following:

double

String

Optional<Variable> variable

A variable reference.

String name

The variable name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<Modifier> modifier

Optional arithmetic modifier.

List<Arg> args

One of the following:

double

String

ModifierOp name

The modifier operation.

One of the following:

ADD("ADD")

SUBTRACT("SUBTRACT")

Optional<FieldPeriod> period

Optional reporting period.

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

String name

LocalDateTime updatedAt

Optional<List<FieldRef>> columns

Field references included when running this screener.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

DeprecatedOptional<List<FieldRef>> fieldFilter

Deprecated: use columns instead. Mirrors columns.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<List<SortSpec>> sorts

FieldRef field

The field to sort by.

String name

The field name.

Optional<FieldLookback> lookback

Optional historical lookback window.

One of the following:

ONE_DAY("ONE_DAY")

ONE_WEEK("ONE_WEEK")

ONE_MONTH("ONE_MONTH")

THREE_MONTHS("THREE_MONTHS")

SIX_MONTHS("SIX_MONTHS")

YEAR_TO_DATE("YEAR_TO_DATE")

ONE_YEAR("ONE_YEAR")

Optional<FieldPeriod> period

Optional reporting period (e.g. quarter or TTM).

One of the following:

QUARTER("QUARTER")

TRAILING_TWELVE_MONTHS("TRAILING_TWELVE_MONTHS")

Optional<FieldType> valueType

The data type of the field value. Present only in responses.

One of the following:

DECIMAL("DECIMAL")

INTEGER("INTEGER")

STRING("STRING")

ANALYST_RATING("ANALYST_RATING")

DATE("DATE")

Optional<SortDirection> direction

Sort direction (defaults to DESC).

One of the following:

ASC("ASC")

DESC("DESC")

Replace Screener

Java

HTTP

TypeScript

Python

Java

Go

CLI Tool

package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.screener.ScreenerReplaceScreenerParams;
import com.clearstreet.api.models.v1.screener.ScreenerReplaceScreenerResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        ScreenerReplaceScreenerResponse response = client.v1().screener().replaceScreener("550e8400-e29b-41d4-a716-446655440000");
    }
}

200 example

400 example

404 example

{
  "data": {
    "columns": [
      {
        "name": "symbol"
      },
      {
        "name": "price"
      },
      {
        "name": "market_cap"
      }
    ],
    "created_at": "2026-04-23T13:37:04.041398Z",
    "filters": [
      {
        "left": {
          "name": "market_cap"
        },
        "op": {
          "name": "GTE"
        },
        "right": [
          {
            "value": 1000000000
          }
        ]
      }
    ],
    "id": "69fcb40a-1812-4856-b2d3-97dec805efee",
    "name": "Tech Large Caps",
    "sorts": [
      {
        "direction": "ASC",
        "field": {
          "name": "market_cap"
        }
      }
    ],
    "updated_at": "2026-04-23T13:37:21.860106Z"
  },
  "metadata": {
    "request_id": "71ac58a8-9b12-49b9-8301-6239febe4e56"
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to parse the request body as JSON: trailing comma at line 3 column 1"
  },
  "metadata": {
    "request_id": "b8d191a9-0f76-4867-996e-4845ae01d864"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "2cf7b8b2-f4c7-4db5-a617-b45324352fb7"
  }
}

Returns Examples

200 example

400 example

404 example

{
  "data": {
    "columns": [
      {
        "name": "symbol"
      },
      {
        "name": "price"
      },
      {
        "name": "market_cap"
      }
    ],
    "created_at": "2026-04-23T13:37:04.041398Z",
    "filters": [
      {
        "left": {
          "name": "market_cap"
        },
        "op": {
          "name": "GTE"
        },
        "right": [
          {
            "value": 1000000000
          }
        ]
      }
    ],
    "id": "69fcb40a-1812-4856-b2d3-97dec805efee",
    "name": "Tech Large Caps",
    "sorts": [
      {
        "direction": "ASC",
        "field": {
          "name": "market_cap"
        }
      }
    ],
    "updated_at": "2026-04-23T13:37:21.860106Z"
  },
  "metadata": {
    "request_id": "71ac58a8-9b12-49b9-8301-6239febe4e56"
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to parse the request body as JSON: trailing comma at line 3 column 1"
  },
  "metadata": {
    "request_id": "b8d191a9-0f76-4867-996e-4845ae01d864"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "2cf7b8b2-f4c7-4db5-a617-b45324352fb7"
  }
}