Skip to main content
POST
Create Generic Asset

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 user-owned generic asset (basket).

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 generic asset with its resolved members (detail view).

generic_asset_id
string<uuid>
required
name
string
required
members
MarketSearchResult · object[]
required
inserted_at
string
required

Creation timestamp (UTC)

owner_subaccount_id
string<uuid> | null
description
string | null
category
string | null
subcategory
string | null
resolves_at
string<date-time> | null
status
string | null