Accounts

TypeScript Type Definitions

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

string

required

A human-readable name for the account.

string

required

The account type. Common values: business, personal, customer.

curl -X POST https://crypto-api.yativo.com/api/v1/accounts/create-account \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_name": "Main Treasury",
    "account_type": "business"
  }'

const account = await client.accounts.create({
  account_name: 'Main Treasury',
  account_type: 'business',
});

account = client.accounts.create(
    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/v1/accounts/get-accounts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const accounts = await client.accounts.list();

accounts = client.accounts.list()

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.

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/v1/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.

string

required

The ID of the account to connect.

array

required

Array of chain identifiers to connect. See Supported Chains for valid values.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/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.

string

Filter connections by account ID. If omitted, returns connections for all accounts.

cURL

curl -X GET "https://crypto-api.yativo.com/api/v1/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/v1/

curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/accounts/create-account' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_name": "Sandbox Treasury",
    "account_type": "business"
  }'

const sdk = new YativoSDK({
  baseURL: 'https://crypto-sandbox.yativo.com/api/v1/',
  apiKey: 'YOUR_SANDBOX_API_KEY',
  apiSecret: 'YOUR_SANDBOX_API_SECRET',
});

const account = await sdk.accounts.create({
  account_name: 'Sandbox Treasury',
  account_type: 'business',
});
console.log('Account ID:', account.id);

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Create an Account

Get All Accounts

Get User Accounts

Create Connections

Get Connections

Account Hierarchy

Sandbox Testing

​Create an Account

​Get All Accounts

​Get User Accounts

​Create Connections

​Get Connections

​Account Hierarchy

​Sandbox Testing

Create an Account

Get All Accounts

Get User Accounts

Create Connections

Get Connections

Account Hierarchy

Sandbox Testing