Skip to main content
POST
Create prediction proposal

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer murmo_.... Keys are created in the Murmo app. Header-only — keys are never read from the query string. Valid for the REST API under /api/v1 only (not the GraphQL endpoint).

Body

application/json
groupId
string
required
eventId
string
required

Event slug (e.g. presidential-election-winner-2028), as returned by the events endpoints.

marketId
string
required

Market slug for the specific market within the event (e.g. will-jd-vance-win-the-2028-us-presidential-election); the side is chosen with isYes.

isYes
boolean
required

Buy the YES side (true) or NO side (false).

amountUsd
string
required

Minimum $4, and at least the market's venue minimum (typically 5 contracts at the current price — see MIN_ORDER_SIZE).

Example:

"12.50"

reason
string
Maximum string length: 500

Response

Created proposal and the opening trade (or a PENDING settling receipt).

data
object