Skip to main content
POST
/
api
/
v1
/
user
/
accounts
Create account
curl --request POST \
  --url https://api.example.com/api/v1/user/accounts
Beta — This endpoint is currently under construction. Behavior and field requirements may change before the stable release.
Requires X-Api-Key, X-Api-Secret, and Authorization: Bearer <user-jwt> headers. See Authentication for details.
A user can hold multiple accounts in different currencies. Each account is isolated in the ledger and identified by a unique id used across deposit, transfer, and transaction endpoints.

​
Request

POST /api/v1/user/accounts

​
Body

FieldTypeRequiredDescription
descriptionstringYesHuman-readable name for the account
assetstringYesCurrency: "USDC"
{
  "description": "Main Account",
  "asset": "USD",
  "type": "LIABILITY"
}

​
Response

201 Created 
{
  "id": 619,
  "description": "Main Account",
  "asset": "USD",
  "type": "LIABILITY",
  "balance": 0
}
FieldTypeDescription
idnumberUnique account ID — use this in deposit, transfer, and transaction requests
descriptionstringName provided at creation
assetstringCurrency of the account
typestring"LIABILITY"
balancenumberInitial balance in smallest unit (always 0 at creation)