CLclear-street
Screener

Create Screener

Changed on

Create a saved screener configuration.

Persists a screener configuration for the authenticated user.

post/v1/saved-screeners

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Request body

namestring nullable

The name for this screener configuration

sharedboolean nullable

Whether any user may fetch this screener by id. Omit to leave the existing value unchanged (defaults to false when creating).

Example request

{
  "columns": [
    {
      "name": "market_cap"
    }
  ],
  "filters": [
    {
      "left": {
        "name": "market_cap"
      },
      "op": {
        "name": "GREATER_OR_EQUAL"
      },
      "right": [
        {
          "value": 1000000000
        }
      ]
    }
  ],
  "sorts": [
    {
      "direction": "DESC",
      "field": {
        "name": "market_cap"
      }
    }
  ]
}

Response

Screener created successfully

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": {
    "columns": [
      {
        "name": "market_cap"
      }
    ],
    "filters": [
      {
        "left": {
          "name": "market_cap"
        },
        "op": {
          "name": "GREATER_OR_EQUAL"
        },
        "right": [
          {
            "value": 1000000000
          }
        ]
      }
    ],
    "sorts": [
      {
        "direction": "DESC",
        "field": {
          "name": "market_cap"
        }
      }
    ]
  }
}

Changes

  • 1bd9eddeffc8Revision changes
    • info

      added the new optional request property

    • info

      added the required property // to the response with the status

  • 169e8b9ad50cRevision changes
    • warning

      added the new ANNUAL enum value to the //////// response property for the response status

    • warning

      added the new ANNUAL enum value to the ///////// response property for the response status

    • warning

      added the new ANNUAL enum value to the /////////////// response property for the response status

    • warning

      added the new ANNUAL enum value to the ///////// response property for the response status

    • info

      added the new ANNUAL enum value to the request property //////

    • info

      added the new ANNUAL enum value to the request property ///////

    • info

      added the new ANNUAL enum value to the request property /////////////

    • info

      added the new ANNUAL enum value to the request property ///////