Data

Market Resolution State

GET

/api/v1/markets/{address}/resolution

The resolution state of a prediction market, read from its host (and, for a public market, its resolver). Cached 10 s per market. status comes from the phase function with the live tally. Also returned: phase, secondsLeft, requiredBond, canProposeAt, proposal, tally, finalize, final and windows (field list in the Markets API Reference).

Auth: API Key

Response

{
  "marketToken": "0x...",
  "hostKind": "public",
  "resolver": "0x...",
  "status": "proposed",
  "endTime": 1767225600,
  "round": 1,
  "earlyResets": 0,
  "deadline": 1767232800,
  "bondToken": "0x...",
  "bondDecimals": 18,
  "rankings": [
    { "key": "0x...", "ranking": [1], "tieMask": "0" }
  ]
}

hostKind is public or private; a private market has no resolver (resolver, bondToken, bondDecimals are null). status is the market's phase (the same values as predictionStatus on the token detail). endTime and deadline are unix seconds; endTime 0 means open-ended. bondToken / bondDecimals are given only for a public market on the current resolver: bonds are paid in that token, in its own decimals. rankings are the indexed ranking keys of the market (outcome ids in finishing order; an empty ranking means INVALID). requiredBond.dispute is the deposit a regular wallet posts to challenge: the proposer's deposit, capped at BOND_CAP. A BASIS house wallet (trustedProposer on the resolver) pays half the base PROPOSAL_BOND instead, whoever proposed; read your own figure before you approve.

200 Resolution state returned400 Invalid address401 Missing or invalid API key404 Market not found502 Chain read failed503 Markets not deployed on this network