Feed

post/api/feed/v1/screen

Request

  • Base URL: https://api.findticker.com
  • URL: https://api.findticker.com/api/feed/v1/screen
  • Auth: HTTP bearer

Request body

querystring required

The question, in plain language. It is compiled to a screener predicate by the same model the product's own screener uses.

pageinteger
limitinteger

Rows per page. Cap 100: a larger value returns at most 100 rows, never an error. Every row costs one unit.

Example request

{
  "query": "concerts under $80 next month with lots of listings"
}

Response

The events matching a question asked in plain language, plus the predicate the question compiled to. Values are as of computed_at and refresh with each rollup job. Costs one unit per event returned, plus one screener run from the account's plan quota.

querystring required
predicateobject required

The predicate that ran, in the screener's own filter language. Filters only, never an ordering.

notestring nullable

What the compile could not do with the question, when it could not do all of it.

totalinteger nullable required

Example response

{
  "rows": [
    {
      "computed_at": "2026-09-01T14:05:11.000Z",
      "primary_status": "rescheduled",
      "prediction_markets": [
        {
          "seriesRef": "KXNFLGAME",
          "seriesTitle": "Pro Football Game Winner",
          "marketRef": "KXNFLGAME-26AUG13DETCIN-DET",
          "yesSubTitle": "Detroit",
          "occurrenceDate": "2026-08-13",
          "probability": 0.62,
          "probabilityDate": "2026-08-07",
          "previousProbability": 0.58,
          "previousProbabilityDate": "2026-08-06",
          "performerId": "pfq4n8r2w6tz",
          "performerName": "Detroit Lions"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.