Skip to main content
POST
Build Parlay

Authorizations

X-River-Key-Id
string
header
required

UUID of your API key (from Settings → API Keys).

X-River-Timestamp
string
header
required

Current unix milliseconds (unix seconds also accepted). Must be within 30s of server time.

X-River-Signature
string
header
required

Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.

Body

application/json
subaccount_id
string<uuid>
required

Subaccount to build under

exchange
string
required

KALSHI or POLYMARKET_US

legs
BuildLeg · object[]
required

Legs to combine, all on the chosen exchange

Minimum array length: 2

Response

Successful Response

The combo as a River market: pass river_id to POST /v1/rfqs, or trade it like any market.

river_id
integer
required