Skip to main content
POST
Create Watchlist

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 seconds. 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

Request schema for creating a new watchlist.

subaccount_id
string<uuid>
required
name
string
required
Maximum string length: 255
description
string | null
river_ids
integer[] | null

Response

Successful Response

Response schema for a watchlist with its resolved members (detail view).

members are ordered by position; river_ids is the same ordering as a convenience for handing straight to the multibook handoff.

watchlist_id
string<uuid>
required
owner_subaccount_id
string<uuid>
required
name
string
required
river_ids
integer[]
required
members
MarketSearchResult · object[]
required
created_at
string
required

Creation timestamp (UTC)

description
string | null