Market data and fundamentals

Equity screener

Stored company metrics filtered by your criteria across one immutable snapshot

1 endpointFrom 4 credits

Try it

curl "https://api.gloom.sh/v1/equity-screener?definition=%7B%22version%22%3A1%2C%22criteria%22%3A%5B%5D%2C%22sort%22%3A%7B%22field%22%3A%22symbol%22%2C%22direction%22%3A%22asc%22%7D%2C%22currency%22%3Anull%7D" \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"

import os
import requests

response = requests.get(
    "https://api.gloom.sh/v1/equity-screener?definition=%7B%22version%22%3A1%2C%22criteria%22%3A%5B%5D%2C%22sort%22%3A%7B%22field%22%3A%22symbol%22%2C%22direction%22%3A%22asc%22%7D%2C%22currency%22%3Anull%7D",
    headers={"Authorization": f"Bearer {os.environ['GLOOM_DATASETS_KEY']}"},
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://api.gloom.sh/v1/equity-screener?definition=%7B%22version%22%3A1%2C%22criteria%22%3A%5B%5D%2C%22sort%22%3A%7B%22field%22%3A%22symbol%22%2C%22direction%22%3A%22asc%22%7D%2C%22currency%22%3Anull%7D",
  { headers: { Authorization: `Bearer ${process.env.GLOOM_DATASETS_KEY}` } },
)
if (!response.ok) throw new Error(await response.text())
console.log(await response.json())

Response

{
  "data": {
    "version": 1,
    "status": "partial",
    "definition": {
      "version": 1,
      "criteria": [],
      "sort": {
        "field": "symbol",
        "direction": "asc"
      },
      "currency": null
    },
    "rows": [
      {
        "symbol": "COST",
        "exchange": "NASDAQ",
        "currency": "USD",
        "metrics": {
          "marketCap": {
            "value": 420461051904,
            "unit": "USD",
            "asOf": null,
            "availableAt": null,
            "observedAt": "2026-10-08T17:00:52.824Z",
            "source": "gloom",
            "state": "partial",
            "scope": "reported",
            "reason": "Provider observation date unavailable; collection time is reported separately",
            "sourceUrl": null,
            "percentile": {
              "value": null,
              "sampleCount": 1,
              "scope": "covered-universe"
            }
          },
          "trailingPE": {
            "value": 45.70544,
            "unit": "x",
            "asOf": null,
            "availableAt": null,
            "observedAt": "2026-10-08T17:00:52.824Z",
            "source": "gloom",
            "state": "partial",
            "scope": "reported",
            "reason": "Provider observation date unavailable; collection time is reported separately",
            "sourceUrl": null,
            "percentile": {
              "value": null,
              "sampleCount": 1,
              "scope": "covered-universe"
            }
          }
        }
      }
    ],
    "nextCursor": null
  },
  "meta": {
    "dataset": "equity-screener",
    "requestId": "sample-request",
    "asOf": null,
    "dataThrough": "2026-10-08T17:00:52.824Z",
    "historyStart": null,
    "updatedAt": "2026-10-08T17:00:52.824Z",
    "page": null,
    "next": null,
    "coverage": {
      "covered": 1,
      "skipped": 0,
      "matched": 1
    },
    "source": [
      {
        "attribution": "U.S. Securities and Exchange Commission and the filing issuer"
      },
      {
        "attribution": "Exchange and market data providers"
      },
      // … 1 more items
    ]
  }
}

Trimmed · 2026-10-08

Run it without a key: GET /v1/datasets/equity-screener/sample

Endpoints

GET/v1/equity-screener4 creditsScreen equities using a structured query

Parameters

definitionstringrequired: JSON string describing the existing screen query.