Screener Filters

GET

financials

screener

filters

List executable screener filters

curl --request GET \
  --url https://financialdatasets.rip/financials/search/screener/filters \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/search/screener/filters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/search/screener/filters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/search/screener/filters"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/search/screener/filters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metrics": {
    "company": [
      {
        "field": "exchange",
        "operators": [
          "eq"
        ],
        "values": [
          "AMEX",
          "NASDAQ",
          "NYSE"
        ]
      },
      {
        "field": "market_cap",
        "operators": [
          "eq"
        ],
        "values": [
          "mega",
          "large",
          "mid",
          "small",
          "micro",
          "nano"
        ]
      }
    ]
  },
  "operators": [
    "eq"
  ]
}

This route returns the exact executable filter catalog for Stock Screener: field names, operators, and allowed values, so a client can check what is filterable before building a request. It is a static, deterministic list. No Monid call is made.

What this answers

Which filter fields and values POST /financials/search/screener will actually accept.

Coverage


Provider chain	None, static, no Monid call
Measured cost	$0 per call
Cache TTL	Not cached, the response never changes

Query rules

This route accepts no parameters.

Worked example

curl

curl -s 'https://financialdatasets.rip/financials/search/screener/filters' \
  -H 'X-API-KEY: <your-api-key>'

Response

{
  "metrics": {
    "company": [
      {
        "field": "exchange",
        "operators": [
          "eq"
        ],
        "values": [
          "AMEX",
          "NASDAQ",
          "NYSE"
        ]
      },
      {
        "field": "market_cap",
        "operators": [
          "eq"
        ],
        "values": [
          "mega",
          "large",
          "mid",
          "small",
          "micro",
          "nano"
        ]
      }
    ]
  },
  "operators": [
    "eq"
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Response

The real, deterministic filter catalog this server returns.

The executable screen_stocks filter catalog. Only exchange and market_cap are implemented today (the eq operator only); this is a strict subset of the full Financial Datasets screener catalog.

metrics

object

required

Filter fields grouped by category. Only the "company" category (exchange, market_cap) is populated today.

Show child attributes

operators

string[]

required

Operators supported anywhere in the catalog. Always ["eq"] today.

List executable screener filters

curl --request GET \
  --url https://financialdatasets.rip/financials/search/screener/filters \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/financials/search/screener/filters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/financials/search/screener/filters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/financials/search/screener/filters"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/financials/search/screener/filters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metrics": {
    "company": [
      {
        "field": "exchange",
        "operators": [
          "eq"
        ],
        "values": [
          "AMEX",
          "NASDAQ",
          "NYSE"
        ]
      },
      {
        "field": "market_cap",
        "operators": [
          "eq"
        ],
        "values": [
          "mega",
          "large",
          "mid",
          "small",
          "micro",
          "nano"
        ]
      }
    ]
  },
  "operators": [
    "eq"
  ]
}

Overview

Integrations

Datasets

Guides

MCP Tools

What this answers

Coverage

Query rules

Worked example

Authorizations

Response

​What this answers

​Coverage

​Query rules

​Worked example

Authorizations

Response

What this answers

Coverage

Query rules

Worked example