Skip to main content

Create subaccount

POST 
/subaccounts

Creates a new subaccount under the main account.

info

This is a private endpoint. To send requests, you need to authenticate.

warning

To use this private endpoint, you must use the API key of your main account with the Administrative permission.

Rate limit weight points: 5

Request​

Body

    labelstring

    Your description of the subaccount, up to 100 characters.

    Possible values: <= 100 characters

Responses​

The request was successful.

Response Headers
    bitvavo-ratelimit-remaining

    The number of remaining weight points before it resets at bitvavo-ratelimit-resetat.

    bitvavo-ratelimit-resetat

    The time when bitvavo-ratelimit-remaining resets to bitvavo-ratelimit-limit.

    bitvavo-ratelimit-limit

    The number of available weight points in one minute.

Schema
    idstringrequired

    The unique identifier of the subaccount.

    typestringrequired

    The type of the subaccount.

    Possible values: [spot, margin]

    statusstringrequired

    The status of the subaccount.

    Possible values: [open, closed]

    labelstring

    Your description of the subaccount, up to 100 characters.

    Possible values: <= 100 characters