prediction-markets

Read-only prediction-market quote (price, eligibility, freshness)

Never mutates state. Returns entry probability, share estimate, max payout, eligibility, and freshness for a binary market outcome. Pass side: "no" to quote backing the NO side (default is yes). Requires scope read. stakeMusd must be > 0 (min to OPEN is 10). An optional minEntryProbabilityPct applies a configured risk floor to the fresh chosen-side quote; it is a finite probability in percentage points before fees, with no default. Invalid values return 400.

post/api/agent/pm/quote

Request

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

Request body

sourcestring required

Source slug, e.g. kalshi / polymarket (lowercased)

slugstring required

Event slug (lowercased)

outcomeExternalMarketIdstring required

Case-sensitive outcome/market id

side'yes' | 'no'

Which side of the binary outcome to back. "yes" (default) pays out if the outcome resolves true; "no" pays out if it resolves false (a NO entry fills at 100 minus the outcome probability).

stakeMusdnumber required

mUSD to stake (> 0; min to open is 10)

forecastProbabilitynumber

Optional own probability that the chosen side wins (0-100 exclusive). Used only for advisory edge sizing; never changes stakeMusd.

bankrollMusdnumber

Optional bankroll in mUSD for the advisory suggested stake.

minEntryProbabilityPctnumber

Optional finite minimum chosen-side entry probability in percentage points before fees (0-100 inclusive). When present, the fresh quote must meet this configured risk floor; omitted preserves prior behavior.

Response

OK

eligibleboolean
blockReasonsstring[]

Eligibility reason codes, including entry_below_floor when the optional minimum entry probability is not met and entry_price_unavailable when the quoted probability is unusable.

fillBasisstring
side'yes' | 'no'
entryProbabilitynumber nullable

Fresh chosen-side entry probability in percentage points (0-100), or null when unavailable; this is the value checked against minEntryProbabilityPct.

sharesEstimatenumber nullable
maxPayoutnumber nullable
stakeMusdnumber
minStakenumber
frozenEntrySnapshotobject
openBlockedboolean

Preview of the pm/open quality gate for this event: true when a pm/open attempt would be rejected 422 right now (quality state missing, stale, or decisionEligible=false). Distinct from eligible/blockReasons, which describe the mock-entry shape gate — both must pass to open.

openBlockReasonsstring[]

Stable reason codes mirroring what pm/open would return (quality_state_missing, quality_state_stale, or the stored blockReasons).

Example response

{
  "fillBasis": "outcome_probability",
  "minStake": 10,
  "executionModel": {
    "version": "paper_execution_v1",
    "fundingMode": "binance_perp_rate_v1"
  },
  "observation": {
    "schema": "coinrithm.agentObservation.v1"
  }
}

Changes

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