Users API

Create and manage end users. Each user gets an automatically provisioned wallet on Base.

Endpoints

Endpoint	Method	Description
/api/v1/partners/users	GET	List users
/api/v1/partners/users	POST	Create user

Create User

Create a new user and provision a wallet:

HTTPPOST

curl -X POST https://api.etbx.com/api/v1/partners/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalId": "user_001", "email": "user@example.com"}'

Request Fields

Field	Type	Required
externalId	string	Yes
email	string	Yes
name	string	No
phone	string	No

Responsejson

{
  "id": "waas_xxx_user_001",
  "externalId": "user_001",
  "email": "user@example.com",
  "walletAddress": "0x742d..."
}

List Users

Get all users:

HTTPGET

curl -X GET https://api.etbx.com/api/v1/partners/users -H "Authorization: Bearer YOUR_API_KEY"

Idempotency

Creating a user with the same externalId returns the existing user. The API is idempotent.

Next Steps

Transfers - Disburse ETB
Treasury - Manage funds