Skip to content
DENPA DOCS

SITUATIONS

GET
/api/situations

The developing stories THE WIRE is monitoring: every moving market in one provider event collapsed into a single ranked story. Read peakDelta and markets[]; never sum the deltas. Always 200, empty on error. CORS-open — a fork may fetch it from the browser. SDK client.getSituations().

Authorizations

Section titled “Authorizations ”
  • None

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
lane

Content lane (@denpa/core DenpaLane). OTHER is the unclassified fallback and is not a filter chip.

string
Allowed values: POLITICS CRYPTO SPORT CULTURE MUSIC TECH ECONOMY SCIENCE WORLD ENTERTAINMENT OTHER

Restrict to one content lane. Unknown values are ignored (no filter).

window
string
Allowed values: 15m 1h 6h 24h

Movement window. Default 24h.

limit
integer
default: 30 >= 1 <= 100

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

object
situations
required
Array<object>

Every moving market in one provider event collapsed into a single story. Read peakDelta and markets[]; never sum the deltas — mutually exclusive buckets cancel to zero. id is stable across polls.

object
id
required
string
eventKey
required

event:<id> / slug:<s> / market:<id>.

string
provider
required
string
Allowed values: polymarket kalshi limitless manifold manual
headline
required
string
lane
required

Content lane (@denpa/core DenpaLane). OTHER is the unclassified fallback and is not a filter chip.

string
Allowed values: POLITICS CRYPTO SPORT CULTURE MUSIC TECH ECONOMY SCIENCE WORLD ENTERTAINMENT OTHER
markets
required

Sorted by |delta| descending.

Array<object>
object
marketId
required
string
title
required
string
outcome
required
string
fromProbability
required
number
toProbability
required
number
delta
required
number
volume
number
wireScore
required
number
url
string
marketCount
required
integer
leadMarketId
required
string
peakDelta
required

Signed delta of the lead market.

number
volume
required

Summed 24h volume across the cluster.

number
situationScore
required
number
criticality
required
string
Allowed values: Routine Elevated Critical
windowSeconds
required
integer
detectedAt
required
string format: date-time
url
string
updatedAt
required
string format: date-time
window
required
string
Allowed values: 15m 1h 6h 24h
windowSeconds
required
integer
coverage
required
object
providerMarketsFetched
required
integer
eligibleMarkets
required
integer
wireEvents
required
integer
situations
required
integer
returned
required
integer
coverageStatus
required
string
Allowed values: complete partial