API Documentation

⌘K
Get Started
APIs
Get free key
POST/api/1/screener/screen

Stock Screener

Filter stocks by fundamental criteria (market cap, P/E, sector, country, etc.). Filters use { id, value, equality } where equality is one of <=, >=, =, IN, NOT_IN, LIKE. String filters (country, gsector, ...) should use IN with an array value; numeric filters (marketCap, ...) use <=, >= or =. Example: [{ "id": "country", "value": ["US"], "equality": "IN" }, { "id": "marketCap", "value": 1000000000, "equality": ">=" }]. See /screener/metadata for available countries, sectors, and industries.

Request Body

application/json
object
filtersarray

Filter criteria. Each entry: { id: column, value, equality: "<=" | ">=" | "=" | "IN" | "NOT_IN" | "LIKE" }. "field" is accepted as an alias for "id"; equality defaults to IN for strings/arrays and >= for numbers.

Array of:
object
idstring

Column to filter on (e.g. country, gsector, marketCap, ipo, index)

fieldstring

Alias for id

value

Filter value: number, string, or array of strings (for IN/NOT_IN)

equalitystring
Allowed values:
<=>==INNOT_INLIKE
orderobject

Sort order (e.g. { field: "marketCap", direction: "desc" })

pagenumber

Page number (0-based)

Default:0
sizenumber

Results per page (max 100)

Default:100

Responses

Was this helpful?
Request
curl -X POST \
  'https://api.eulerpool.com/api/1/screener/screen' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'
200 Response
[
  {
  "isin": "US0378331005",
  "ticker": "AAPL",
  "name": "Apple",
  "country": "string",
  "sector": "string",
  "industry": "string",
  "marketCap": 0
}
]