Skip to main content
POST
/
api
/
v1
/
spot
/
proposals
Create spot proposal
curl --request POST \
  --url https://api.alpha-labs.trade/api/v1/spot/proposals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groupId": "1a9d212a-de67-45f4-88f5-6e9f41e78dc0",
  "contractAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "reason": "Momentum breakout",
  "amountUsd": "50.00"
}
'
{
  "data": {
    "proposal": {
      "id": "<string>",
      "groupId": "<string>",
      "createdByUserDynamicId": "<string>",
      "tokenMetadataId": "<string>",
      "reason": "<string>",
      "initialPriceUsd": "12.50",
      "exitPriceUsd": "12.50",
      "exitPnlPct": "4.27",
      "exitPnlUsd": "12.50",
      "closedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "token": {
        "id": "<string>",
        "contractAddress": "<string>",
        "symbol": "<string>",
        "name": "<string>",
        "logoUrl": "<string>",
        "coingeckoId": "<string>",
        "verified": true
      },
      "group": {
        "uniqueId": "<string>",
        "name": "<string>",
        "image": "<string>"
      },
      "createdBy": {
        "dynamicId": "<string>",
        "username": "<string>"
      },
      "trades": [
        {
          "id": "<string>",
          "tradingProposalId": "<string>",
          "groupId": "<string>",
          "walletAddress": "<string>",
          "tokenAmount": "4.27",
          "tokenDecimals": 123,
          "pricePerTokenUsd": "12.50",
          "totalCostUsd": "12.50",
          "alphaFeeUsd": "12.50",
          "pnlPct": "4.27",
          "pnlUsd": "12.50",
          "txSignature": "<string>",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ]
    },
    "trade": {
      "id": "<string>",
      "tradingProposalId": "<string>",
      "groupId": "<string>",
      "walletAddress": "<string>",
      "tokenAmount": "4.27",
      "tokenDecimals": 123,
      "pricePerTokenUsd": "12.50",
      "totalCostUsd": "12.50",
      "alphaFeeUsd": "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
contractAddress
string
required
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