Screener run

POST/v1/screener/runPromised whole

Run a screen and return the matching securities.

Response contract

Every field in the response is part of the contract.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

countoffsetlimithas_morecolumnscriteria_countrowscoverage

How this was verified

Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl -X POST "https://api.massari.ai/v1/screener/run" \
  -H "Authorization: Bearer $MASSARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"filters":[{"metric":"market_cap","op":"gte","value":1000000000000}],"limit":3}'