Skip to main content
POST
/
api
/
v1
/
predictions
/
proposals
Create prediction proposal
curl --request POST \
  --url https://api.alpha-labs.trade/api/v1/predictions/proposals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groupId": "1a9d212a-de67-45f4-88f5-6e9f41e78dc0",
  "eventId": "KXNFLGAME-25SB",
  "marketId": "KXNFLGAME-25SB-KC",
  "isYes": true,
  "amountUsd": "10.00",
  "reason": "KC value"
}
'
{
  "data": {
    "proposal": {
      "id": "<string>",
      "groupId": "<string>",
      "createdById": "<string>",
      "eventId": "<string>",
      "marketId": "<string>",
      "outcomeMint": "<string>",
      "eventTitle": "<string>",
      "marketTitle": "<string>",
      "eventImageUrl": "<string>",
      "isYes": true,
      "status": "<string>",
      "result": "<string>",
      "didWin": true,
      "reason": "<string>",
      "resolvedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "trade": {
      "id": "<string>",
      "proposalId": "<string>",
      "groupId": "<string>",
      "walletAddress": "<string>",
      "tradeType": "<string>",
      "tokenAmount": "4.27",
      "tokenDecimals": 123,
      "pricePerTokenUsd": "12.50",
      "totalCostUsd": "12.50",
      "pnlPct": "4.27",
      "pnlUsd": "12.50",
      "txSignature": "<string>",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  }
}

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

Kalshi event ticker.

marketId
string
required

Kalshi market id (the specific outcome).

isYes
boolean
required

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

amountUsd
string
required

A monetary amount as a full-precision plain decimal string in USD — never a number, never raw base units, never scientific notation, never rounded. Parse with a decimal library; round only for display.

Example:

"12.50"

reason
string

Response

Created proposal and the opening trade.

data
object