Create Wallet

This endpoint creates a new wallet in the system. Each wallet has a unique identifier and can be used to hold balances in different cryptocurrencies.

Request

POST /wallets

Request Body

Parameter	Type	Required	Description
name	string	Yes	Custom name for the wallet

Authentication

This endpoint requires authentication using one of the following methods:

• API Key: X-API-Key header
• OAuth 2.0: Authorization: Bearer {access_token} header

Example Request

curl -X POST "https://api.cryptofuse.io/wallets" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Trading Wallet"
  }'

Response

A successful response returns the details of the newly created wallet including its unique identifier.

Example Response

{
  "result": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My Trading Wallet",
    "created_at": "2025-04-30T12:34:56.789Z"
  }
}

Response Fields

Field	Type	Description
result.id	string	Unique ID for the wallet (used in all API calls)
result.name	string	The custom name provided for the wallet
result.created_at	string	ISO 8601 timestamp of wallet creation

Error Responses

Status Code	Error Code	Description
400	invalid_request	Missing or invalid name parameter
401	unauthorized	Authentication failed
403	forbidden	User doesn't have required permissions
500	server_error	Internal server error

Notes

• The wallet ID (id) is automatically generated by the system
• This ID is required for all subsequent operations related to the wallet (checking balances, generating addresses, etc.)
• The name parameter is for your reference only and can be any string you choose
• Each wallet can hold balances in multiple cryptocurrencies
• You can create multiple wallets for different purposes (e.g., trading, savings, etc.)