subaccounts

Create Subaccount

Create a new trading subaccount. Any active org member can create one; account_type is pinned to non_custodial server-side. A non-admin creator gets an explicit admin grant on the new subaccount (org admins hold derived access on every subaccount and never get grant rows).

Runs on the unscoped session: the creator holds no user:manage grant on the subaccount until this transaction writes it, so the scoped-session RLS WITH CHECK on subaccount_grants can never admit the bootstrap row.

post/v1/subaccounts

Request body

namestring required
descriptionstring nullable

Response

Successful Response

subaccount_idstring uuid required
org_idstring uuid required
namestring required
descriptionstring nullable
account_type'custodial' | 'non_custodial' required

Type of trading subaccount.

is_activeboolean required
inserted_atstring required
permissionsstring[] required
rolestring required

Changes

Changed in 1 of the 9 revisions of this API.13

  • cc969517a65d13See the full diff
    • removed the request property

      request-property-removed

    • added the required property to the response with the status

      response-required-property-added

    • added the required property to the response with the status

      response-required-property-added

    • added the required property to the response with the status

      response-required-property-added