Wallets

Endpoints for managing user wallets. All endpoints require authentication.

GET /v1/wallet/all

Returns all wallets belonging to the authenticated user. If the user doesn't have a HyperLiquid wallet yet, one is automatically created on first request.

Headers

Authorization: Bearer <access_token>

Response

{
  "status": 200,
  "data": [
    {
      "id": "1234567890123456789",
      "chain": "HYPERLIQUID",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38"
    }
  ]
}

Wallet Object

Field	Type	Description
id	string	Snowflake ID
chain	string	Blockchain network (currently only "HYPERLIQUID")
address	string	Wallet address on the chain

Supported Chains

Chain	Value	Description
HyperLiquid	"HYPERLIQUID"	Auto-created on first wallet fetch

Error Responses

Status	Error	Cause
401	UNAUTHORIZED	Missing or invalid access token
500	INTERNAL_SERVER_ERROR	Failed to create or fetch wallets

Notes

• The private key is never exposed in the API response. Generated on first GET request if not available.
• The wallet list may grow as more chains are supported.