Skip to main content
POST
TypeScript

Authorizations

Authorization
string
header
required

Private-preview venue operator key (trdrs_vk_sandbox_… or trdrs_vk_production_…). Bound to one venue/environment and explicit scopes. Issued by a verified owner session; accepted only on documented /api/partner/venues/{venueId} routes. Existing trdrs_sk keys are not interchangeable. Never grants trader, login or key-management authority.

Headers

Idempotency-Key
string
required
Required string length: 1 - 128

Path Parameters

venueId
string<uuid>
required
accountId
string
required
stageId
string
required

Body

application/json
startingAllocation
object | null
required

An exact fraction of integers as decimal strings. Money is carried this way until it is posted, so nothing rounds twice on the way to the journal.

Response

Scoped result. Cache-Control: no-store.

advance
object
required

reserved means the successor was named and created but its opening allocation has not been confirmed; advanced means it has. The two stay distinct because creation may one day happen at a provider, where "we asked" and "it exists" are different facts.