prediction-markets

Discover candidates for the acquired-book PM paper model (pm_paper_v2)

Candidate list for pm_paper_v2, the paper model that fills against an order book acquired from the venue at entry time. Only keys enrolled as a server-configured house agent may call it; any other key receives 403 house_opt_in_required.

Built from the same cached discovery set as /api/agent/pm/discover (all sources, best sort, offset 0), then filtered per request: an outcome is kept only when its exact stored native identity resolves (Polymarket condition + token, or Kalshi ticker + side), it is not a Polymarket negative-risk contract, and, when the house has a maxEndDays bound, its scheduled native end falls inside it. Events left with no outcome are dropped; meta.boundedSelection counts what was removed and why. Dates are stored provider fields, not a settlement guarantee; entry re-acquires identity, maturity, book and fees. Only q and limit are accepted; any other query parameter returns 400. The legacy quoteHint on each market still points at the v1 quote endpoint. Requires scope read.

get/api/agent/pm/v2/discover

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/agent/pm/v2/discover
  • Auth: HTTP bearer

Query parameters

qstring

Search text matched against event title, outcomes, topics, and related coins.

limitinteger

Events requested before filtering (decimal, no leading zeros).

Response

OK

executionModel'pm_paper_v2' required

Example response

{
  "data": [
    {
      "quoteHint": {
        "endpoint": "POST /api/agent/pm/quote",
        "stakeMusdMin": 10,
        "outcomeExternalMarketIdField": "outcomes[].externalMarketId"
      }
    }
  ]
}

Changes

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