TEtesser
Accounts

Create a new wallet account

Create a new stablecoin wallet account.

Supported Networks:

  • stablecoin_ethereum - Ethereum/Polygon stablecoin wallet
  • stablecoin_solana - Solana stablecoin wallet
  • stablecoin_stellar - Stellar stablecoin wallet

Wallet Types:

  • Managed (is_managed=true) - Tesser-managed wallet, requires signature
  • Unmanaged (is_managed=false, default) - External wallet, requires wallet_address

Ownership: Optionally link to a tenant or counterparty using tenant_id or counterparty_id.

post/v1/accounts/wallets

Request

Request body

tenant_idstring uuid nullable

Tenant ID (mutually exclusive with counterparty_id). Links this wallet to a specific tenant.

counterparty_idstring uuid nullable

Counterparty ID (mutually exclusive with tenant_id). Links this wallet to a specific counterparty.

namestring required

Human-readable name for the wallet account

type'stablecoin_ethereum' | 'stablecoin_solana' | 'stablecoin_stellar' required

Stablecoin network type. Determines which blockchain network the wallet operates on.

signaturestring

A cryptographic stamp used to verify the integrity and authenticity of the request. This ensures the request was signed by an authorized key. Required for managed wallets (is_managed=true). See Documentation > Signing for more details.

is_managedboolean

Whether this is a managed wallet (provisioned by Tesser), or unmanaged (not provisioned by Tesser). Managed wallets (true) require a signature and automatically create USDC/USDT assets. Unmanaged wallets (false) require a wallet_address. Defaults to false.

wallet_addressstring

Blockchain wallet address. Required for unmanaged wallets (is_managed=false). Auto-generated for managed wallets.

Example request

{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440002",
  "counterparty_id": "660e8400-e29b-41d4-a716-446655440003",
  "name": "Treasury Wallet - Ethereum",
  "type": "stablecoin_ethereum",
  "signature": "eyJwdWJsaWNLZXkiOiJwdWJfZXhhbXBsZSIsInNpZ25hdHVyZSI6InNpZ19leGFtcGxlIiwic2NoZW1lIjoiRUQyNTUxOSJ9",
  "wallet_address": "0x742d35CC6634C0532925a3B844BC9e7595f8fe0B"
}

Response

Wallet account created successfully

Example response

{
  "data": {
    "assets": [
      {
        "currency": "USDC",
        "network": "POLYGON",
        "available_balance": "1"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.