v50

latestOpenAPI 3.0.1raw.githubusercontent.com2026-03-2591124300.0 KB

Vaults

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.

post/vaults

Headers

PARADEX-PARENT-ACCOUNTstring required

Onboarded by prdx:0xa123456789

PARADEX-STARKNET-SIGNATUREstring required

Starknet signature

PARADEX-STARKNET-ACCOUNTstring required

Starknet address

PARADEX-STARKNET-ACCOUNT-DERIVATION-PATHstring required

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

Request body

deposit_tx_signaturestring

Initial deposit transfer by vault owner

descriptionstring

Description for the vault

lockup_periodinteger

User's deposits lockup period in days

max_tvlinteger

Max TVL locked by the Vault, if any. 0 for unlimited

namestring

Unique name for the vault

profit_shareinteger

Vault owner profit share (percentage)

public_keystring

Public key of vault operator

Example request

{
  "deposit_tx_signature": "[",
  "description": "My vault description",
  "lockup_period": 1,
  "max_tvl": 1000000,
  "name": "MyVault",
  "profit_share": 10,
  "public_key": "0x1234567890abcdef"
}

Response

Created

addressstring

Contract address of the vault

created_atinteger

Unix timestamp in milliseconds of when the vault has been created

descriptionstring

Description of the vault

kind'user' | 'protocol'

last_updated_atinteger

Unix timestamp in milliseconds of when the vault was last updated

lockup_periodinteger

Lockup period of the vault in days

max_tvlinteger

Maximum amount of assets the vault can hold in USDC

namestring

Name of the vault

operator_accountstring

Operator account of the vault

owner_accountstring

Owner account of the vault

profit_shareinteger

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

status'INITIALIZING' | 'ACTIVE' | 'CLOSED' | 'FAILED'

token_addressstring

LP token address

Example response

{
  "address": "0x1234567890abcdef",
  "created_at": 1517171717,
  "description": "My description",
  "last_updated_at": 1617171717,
  "lockup_period": 1,
  "max_tvl": 1000000,
  "name": "MyVault",
  "operator_account": "0x1234567890abcdef",
  "owner_account": "0x0234567890abcdef",
  "profit_share": 10,
  "strategies": [
    {
      "address": "0x29464b79b02543ed8746bba6e71c8a15401dd27b7279a5fa2f2fe8e8cdfabb",
      "name": "Alpha Strategy"
    }
  ]
}