> ## Documentation Index
> Fetch the complete documentation index at: https://chainstack-docs-polygon-erigon-trace-deprecation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Create vault | Hyperliquid exchange
> Create a new vault on Hyperliquid. Returns the new vault address. On Hyperliquid exchange.
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
This endpoint requires signature authentication. See our comprehensive [Authentication via Signatures guide](/docs/hyperliquid-authentication-guide) for implementation details.
The `createVault` action creates a new vault. On success the response includes the address of the newly created vault.
## Parameters
### Required parameters
* `action` (object, required) — The create-vault action:
* `type` (string) — Must be `"createVault"`.
* `name` (string) — Vault name (3-50 characters).
* `description` (string) — Vault description (10-250 characters).
* `initialUsd` (number) — Initial balance as a USD float multiplied by 1e6 (minimum 100 USD, i.e. `100000000`).
* `nonce` (number) — Timestamp in milliseconds, equal to the envelope nonce.
* `nonce` (number, required) — Current timestamp in milliseconds.
* `signature` (object, required) — EIP-712 signature of the action.
### Optional parameters
* `expiresAfter` (number, optional) — Timestamp in milliseconds after which the request is rejected.
## Returns
Returns an object with the action status:
* `status` — `"ok"` if the request was processed.
* `response` — Contains `type` `"createVault"` and `data`, the address of the new vault.
## Example request
```shell cURL theme={null}
curl -X POST https://api.hyperliquid.xyz/exchange \
-H "Content-Type: application/json" \
-d '{
"action": {
"type": "createVault",
"name": "My vault",
"description": "A vault for copy trading",
"initialUsd": 100000000,
"nonce": 1234567890123
},
"nonce": 1234567890123,
"signature": {...}
}'
```
```python Python (hyperliquid-python-sdk) theme={null}
# Note: the official hyperliquid-python-sdk does not expose a createVault helper
# yet, so build and post the signed action directly.
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
from hyperliquid.utils.signing import sign_l1_action, get_timestamp_ms
import eth_account
# Public Hyperliquid mainnet endpoint
wallet = eth_account.Account.from_key("0x...") # your private key
exchange = Exchange(wallet, constants.MAINNET_API_URL)
timestamp = get_timestamp_ms()
action = {
"type": "createVault",
"name": "My vault",
"description": "A vault for copy trading",
"initialUsd": 100000000, # 100 USD * 1e6
"nonce": timestamp,
}
signature = sign_l1_action(
wallet,
action,
None, # vault_address
timestamp,
None, # expires_after
exchange.base_url == constants.MAINNET_API_URL,
)
result = exchange._post_action(action, signature, timestamp)
print(result)
```
```typescript TypeScript (@nktkas/hyperliquid) theme={null}
import { ExchangeClient, HttpTransport } from "@nktkas/hyperliquid";
import { privateKeyToAccount } from "viem/accounts";
// Public Hyperliquid mainnet endpoint (default transport)
const wallet = privateKeyToAccount("0x..."); // viem or ethers account
const transport = new HttpTransport();
const exchange = new ExchangeClient({ transport, wallet });
const result = await exchange.createVault({
name: "My vault",
description: "A vault for copy trading",
initialUsd: 100000000, // 100 USD * 1e6
});
console.log(result); // response.data is the new vault address
```
## Response example
```json theme={null}
{
"status": "ok",
"response": {
"type": "createVault",
"data": "0x1719884eb866cb12b2287399b15f7db5e7d775ea"
}
}
```
## Use cases
* **Launch a vault** — Open a vault others can deposit into and follow
* **Copy trading** — Let depositors mirror your strategy
* **Capital pooling** — Aggregate capital under a single managed account
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_exchange/exchange_create_vault.json post /exchange
openapi: 3.0.0
info:
title: Hyperliquid Exchange API
version: 1.0.0
description: >-
API for trading operations on Hyperliquid exchange requiring authentication.
⚠️ WARNING: These endpoints require EIP-712 signatures for authentication.
The example values provided will NOT work without proper cryptographic
signing. You must implement EIP-712 signing to use these endpoints
successfully.
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/exchange:
post:
tags:
- hyperliquid exchange
summary: Create vault
operationId: createVault
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action:
type: object
properties:
type:
type: string
default: createVault
enum:
- createVault
description: Action type
name:
type: string
description: Vault name (3-50 characters)
description:
type: string
description: Vault description (10-250 characters)
initialUsd:
type: integer
description: >-
Initial balance as USD float * 1e6 (minimum 100 USD =
100000000)
nonce:
type: integer
description: Timestamp in milliseconds, equal to the envelope nonce
required:
- type
- name
- description
- initialUsd
- nonce
nonce:
type: integer
description: Current timestamp in milliseconds
signature:
type: object
description: EIP-712 signature of the action with r, s, v components
properties:
r:
type: string
example: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s:
type: string
example: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v:
type: integer
example: 27
required:
- r
- s
- v
expiresAfter:
type: integer
description: >-
Timestamp in milliseconds after which the request is
rejected (optional)
required:
- action
- nonce
- signature
example:
action:
type: createVault
name: My vault
description: A vault for copy trading
initialUsd: 100000000
nonce: 1705234567890
nonce: 1705234567890
signature:
r: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v: 27
responses:
'200':
description: Create vault result, including the new vault address
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Request status
response:
type: object
properties:
type:
type: string
default: createVault
data:
type: string
description: Address of the newly created vault
example:
status: ok
response:
type: createVault
data: '0x1719884eb866cb12b2287399b15f7db5e7d775ea'
````