Skip to main content
POST
Join / increase a 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).

Path Parameters

id
string
required

Body

application/json
collateralUsd
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"

leverage
string
required
Example:

"5"

Response

The opened position.

data
object

Result of an open/increase/reduce. Close-side fields are populated on a full close.