Production API ReferenceVaults

Create vault

Create a new vault by providing deployment parameters.Current user will be set as owner of the account and a new sub-account will be deployed as vault operator.

Headers

PARADEX-PARENT-ACCOUNTstringRequired

Onboarded by prdx:0xa123456789

PARADEX-STARKNET-SIGNATUREstringRequired
Starknet signature
PARADEX-STARKNET-ACCOUNTstringRequired
Starknet address
PARADEX-STARKNET-ACCOUNT-DERIVATION-PATHstringRequired

Account derivation path - m/44’/9004’/0’/0/1

Request

Vault parameters
deposit_tx_signaturestringOptional
Initial deposit transfer by vault owner
descriptionstringOptional
Description for the vault
lockup_periodintegerOptional
User's deposits lockup period in days
max_tvlintegerOptional
Max TVL locked by the Vault, if any. 0 for unlimited
namestringOptional
Unique name for the vault
profit_shareintegerOptional

Vault owner profit share (percentage)

public_keystringOptional
Public key of vault operator

Response

Created
addressstring or null
Contract address of the vault
created_atinteger or null
Unix timestamp in milliseconds of when the vault has been created
descriptionstring or null
Description of the vault
kindenum or null

Kind of the vault: ‘user’ for user-defined vaults, ‘protocol’ for vaults controlled by Paradex

Allowed values:
last_updated_atinteger or null
Unix timestamp in milliseconds of when the vault was last updated
lockup_periodinteger or null
Lockup period of the vault in days
max_tvlinteger or null
Maximum amount of assets the vault can hold in USDC
namestring or null
Name of the vault
operator_accountstring or null
Operator account of the vault
owner_accountstring or null
Owner account of the vault
profit_shareinteger or null

Profit share of the vault in percentage, i.e. 10 means 10%

statusenum or null
Status of the vault
Allowed values:
strategieslist of objects or null
Strategies of the vault
token_addressstring or null
LP token address

Errors