Skip to main content
interface Account {
  account_id: string;
  account_name: string;
  account_type: string;
  user_id: string;
  created_at: string;
  updated_at: string;
}

interface CreateAccountRequest {
  account_name: string;
  account_type?: string;
}
Accounts are the top-level organizational unit in Yativo Crypto. Each account holds a collection of wallets (assets) across one or more blockchains. You can create multiple accounts to separate concerns — for example, a treasury account, a hot wallet account, and a per-customer account.

​
Create an Account

POST /accounts/create-account
​
account_name
string
required
A human-readable name for the account.
​
account_type
string
required
The account type. Common values: business, personal, customer.
curl -X POST https://crypto-api.yativo.com/api/accounts/create-account \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_name": "Main Treasury",
    "account_type": "business"
  }'
Response
{
  "id": "acc_01abc123",
  "account_name": "Main Treasury",
  "account_type": "business",
  "status": "active",
  "created_at": "2026-03-26T10:00:00Z"
}

​
Get All Accounts

GET /accounts/get-accounts Returns all accounts belonging to the authenticated user. 
curl -X GET https://crypto-api.yativo.com/api/accounts/get-accounts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "accounts": [
    {
      "id": "acc_01abc123",
      "account_name": "Main Treasury",
      "account_type": "business",
      "status": "active",
      "asset_count": 4,
      "created_at": "2026-03-26T10:00:00Z"
    },
    {
      "id": "acc_02def456",
      "account_name": "Hot Wallet",
      "account_type": "business",
      "status": "active",
      "asset_count": 2,
      "created_at": "2026-03-20T08:00:00Z"
    }
  ]
}

​
Get User Accounts

POST /accounts/get-user-accounts Returns accounts for a specific sub-user or B2B customer. Used when managing accounts on behalf of your customers.
​
user_id
string
required
The ID of the user or customer whose accounts you want to retrieve.
cURL
curl -X POST https://crypto-api.yativo.com/api/accounts/get-user-accounts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "usr_cust_01xyz"}'
Response
{
  "user_id": "usr_cust_01xyz",
  "accounts": [
    {
      "id": "acc_cust_01abc",
      "account_name": "Customer Wallet",
      "account_type": "customer",
      "status": "active",
      "created_at": "2026-03-10T12:00:00Z"
    }
  ]
}

​
Create Connections

POST /accounts/create-connections Connect an account to one or more blockchain networks. This initializes address generation for the specified chains on that account.
​
account_id
string
required
The ID of the account to connect.
​
chains
array
required
Array of chain identifiers to connect. See Supported Chains for valid values.
cURL
curl -X POST https://crypto-api.yativo.com/api/accounts/create-connections \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01abc123",
    "chains": ["ethereum", "solana", "polygon"]
  }'
Response
{
  "account_id": "acc_01abc123",
  "connections": [
    {
      "chain": "ethereum",
      "status": "connected",
      "connected_at": "2026-03-26T10:02:00Z"
    },
    {
      "chain": "solana",
      "status": "connected",
      "connected_at": "2026-03-26T10:02:00Z"
    },
    {
      "chain": "polygon",
      "status": "connected",
      "connected_at": "2026-03-26T10:02:00Z"
    }
  ]
}

​
Get Connections

GET /accounts/get-connections Returns blockchain connections for an account.
​
account_id
string
Filter connections by account ID. If omitted, returns connections for all accounts.
cURL
curl -X GET "https://crypto-api.yativo.com/api/accounts/get-connections?account_id=acc_01abc123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "connections": [
    {
      "account_id": "acc_01abc123",
      "chain": "ethereum",
      "status": "connected",
      "connected_at": "2026-03-26T10:02:00Z"
    },
    {
      "account_id": "acc_01abc123",
      "chain": "solana",
      "status": "connected",
      "connected_at": "2026-03-26T10:02:00Z"
    }
  ]
}

​
Account Hierarchy

Accounts belong to your platform. Within an account, you add Assets (wallets) for specific chains and tokens. For B2B scenarios, use Customers to create managed sub-accounts that belong to your end customers.
Your Platform
├── Account: Main Treasury
│   ├── Asset: ETH (Ethereum)
│   ├── Asset: USDC (Ethereum)
│   └── Asset: SOL (Solana)
└── Account: Customer 001
    ├── Asset: USDC_SOL (Solana)
    └── Asset: USDT_POLYGON (Polygon)

​
Sandbox Testing

Use the sandbox to test this endpoint without real funds:
Sandbox URL: https://crypto-sandbox.yativo.com/api/
curl -X POST 'https://crypto-sandbox.yativo.com/api/accounts/create-account' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_name": "Sandbox Treasury",
    "account_type": "business"
  }'