Create a wallet
This endpoint creates a new wallet for the current user. Each TEOS platform user can have one or more wallets. Wallets are used to store and manage sparks of assets owned by a user.
Each wallet consists of a public address and a private key:
- The public address identifies the wallet in all spark operations.
- The private key, securely stored on the user’s device, is used to sign transactions.
TEOS API consumers can create a wallet to securely manage the sparks of assets owned by a TEOS user.
📘 Learn more about wallets.
Request Endpoint
POST /odata/v1.0/Wallets
Parameters
No query parameters.
Request Body
Content type: application/json — Wallet details to be created.
| Parameter | Type | Description | Mandatory |
|---|---|---|---|
| Name | string | Human-readable name of the wallet. Used to identify it in UI or integrations. | ✅ |
| UserId | string (UUID) | Unique identifier of the user who owns this wallet. | ✅ |
| Signable | boolean | Indicates whether this wallet can sign transactions (true for active wallets managed by the user). | ✅ |
| EthereumAddress/ICPAddress | string | The public blockchain address for this wallet | ✅ |
| Description | string | Optional description providing context about the wallet purpose. | ❌ |
Example Request Body
In EVM-compatible networks (e.g., Sparknet, Ethereum, and Polygon), the "Address" and is 42 characters long. In non-EVM networks, the address length may differ. For example, on Internet Computer (ICPAddress), it is 63 characters.
{
"Name": "Example",
"Description": "This is an example of a wallet",
"UserId": "e38d15e0-b26e-4f2e-b78c-991a46be0644",
"Signable": true,
"EthereumAddress": "0x9f114da25b61b77606d47eab414b9360f8783979"
}
Response Body
Content type: application/json— Returns the details of the created wallet.
| Parameter | Description |
|---|---|
| Id | Unique identifier of the wallet in TEOS Platform. |
| Name | Wallet name as defined during creation. |
| Description | Description text provided by the user. |
| EthereumAddress/ICPAddress | The public blockchain address for this wallet. |
| UserId | Unique identifier of the wallet owner. |
| Signable | Indicates whether this wallet supports signing transactions. |
Example Response Body
In EVM-compatible networks (e.g., Sparknet, Ethereum, and Polygon), the "Address" and is 42 characters long. In non-EVM networks, the address length may differ. For example, on Internet Computer, it is 63 characters.
{
"Id": "346BD08F-8F95-4487-9FB4-17FA19B8A91D",
"Name": "USD Token Wallet",
"Description": "Used for payments",
"EthereumAddress": "0xe0450ce1e2ef73b15514ae6a003b90d0ebac8836",
"UserId": "346BD08F-8F95-4487-9FB4-17FA19B8A91D",
"Signable": true
}
Response Codes
| Code | Description |
|---|---|
| 201 | The wallet was created successfully. |
| 400 | The provided wallet data is invalid. Error details are included. |
| 401 | Unauthorized. |