> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Test: Wallets & Assets

> Test account creation, wallet (asset) creation, and balance checking in the sandbox

## Overview

Use the sandbox to test the full wallet lifecycle — creating accounts, adding crypto assets, and checking balances. All wallet operations in the sandbox use testnet tokens on testnet blockchains.

**Sandbox base URL:** `https://crypto-sandbox.yativo.com/api/v1/`

<Note>
  You must be authenticated with a sandbox access token before calling these endpoints. See [Sandbox Authentication](/sandbox/authentication) to obtain a token.
</Note>

***

## Step 1 — Create an Account

Accounts are containers for your wallets and assets.

```
POST https://crypto-sandbox.yativo.com/api/v1/accounts/create-account
```

```bash cURL theme={null}
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 Main",
    "account_type": "business"
  }'
```

```json Response theme={null}
{
  "status": "success",
  "message": "Account created successfully",
  "data": {
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "account_name": "Sandbox Main",
    "account_type": "business",
    "created_at": "2026-03-28T10:00:00Z"
  }
}
```

***

## Step 2 — Add a Wallet (Asset)

Add a specific blockchain + token combination to your account. This generates a new wallet address on the sandbox testnet.

```
POST https://crypto-sandbox.yativo.com/api/v1/assets/add-asset
```

<ParamField body="account_id" type="string" required>
  The account to add the wallet to.
</ParamField>

<ParamField body="chain" type="string" required>
  Blockchain network: `solana`, `ethereum`, `bitcoin`, `polygon`, `bsc`, `base`, `xdc`.
</ParamField>

<ParamField body="ticker" type="string" required>
  Token ticker symbol: `USDC_SOL`, `ETH`, `BTC`, `USDC_ETH`, `BNB`, etc.
</ParamField>

<CodeGroup>
  ```bash Add USDC on Solana (Devnet) theme={null}
  curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/assets/add-asset' \
    -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
      "chain": "solana",
      "ticker": "USDC_SOL"
    }'
  ```

  ```bash Add ETH on Base (Sepolia) theme={null}
  curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/assets/add-asset' \
    -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
      "chain": "base",
      "ticker": "ETH"
    }'
  ```
</CodeGroup>

```json Response theme={null}
{
  "status": "success",
  "message": "Asset created successfully",
  "data": {
    "asset_id": "ast_01HX9KZMB3F7VNQP8R2WDGT4E6",
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "chain": "solana",
    "ticker": "USDC_SOL",
    "wallet_address": "GY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1",
    "status": "active",
    "created_at": "2026-03-28T10:05:00Z"
  }
}
```

<Note>
  The `wallet_address` is your deposit address for this asset on the testnet. Use a testnet faucet to fund it.
</Note>

***

## Step 3 — List Your Assets

Retrieve all wallets and their balances.

```
POST https://crypto-sandbox.yativo.com/api/v1/assets/get-user-assets
```

<ParamField body="account_id" type="string">
  Filter by a specific account. If omitted, returns all assets across all accounts.
</ParamField>

```bash cURL theme={null}
curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/assets/get-user-assets' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5"
  }'
```

```json Response theme={null}
{
  "data": [
    {
      "id": "ast_01HX9KZMB3F7VNQP8R2WDGT4E6",
      "user_id": "usr_01HX9KZMB3F7VNQP8R2WDGT001",
      "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
      "asset_name": "USD Coin (Solana)",
      "asset_short_name": "USDC",
      "ticker_name": "USDC_SOL",
      "chain": "SOL",
      "address": "GY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1",
      "amount": "0.000000",
      "token_type": "token"
    }
  ],
  "status": true,
  "message": "Assets Listed Successfully"
}
```

***

## Step 4 — List Accounts

Retrieve all accounts with their asset counts and total values.

```
GET https://crypto-sandbox.yativo.com/api/v1/accounts/get-accounts
```

```bash cURL theme={null}
curl -X GET 'https://crypto-sandbox.yativo.com/api/v1/accounts/get-accounts' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN'
```

```json Response theme={null}
{
  "data": [
    {
      "_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
      "account_name": "Sandbox Main",
      "assets": "2",
      "account_value": 0,
      "portfolio": "0.00",
      "archived": "0",
      "subaccount": false,
      "createdAt": "2026-03-28T10:00:00Z"
    }
  ],
  "status": true,
  "message": "Accounts and assets listed successfully"
}
```

***

## Available Testnet Networks

| Network         | Testnet Used | Faucet                                                           |
| --------------- | ------------ | ---------------------------------------------------------------- |
| Solana          | Devnet       | [faucet.solana.com](https://faucet.solana.com)                   |
| Ethereum / Base | Sepolia      | [sepoliafaucet.com](https://sepoliafaucet.com)                   |
| Gnosis          | Chiado       | [faucets.buildwithsygma.com](https://faucets.buildwithsygma.com) |
| Polygon         | Amoy         | Polygon faucet                                                   |
| BNB Chain       | BSC Testnet  | BNB testnet faucet                                               |

<Info>
  Testnet tokens have no monetary value. Use the faucets above to get free testnet tokens and send them to your wallet `address` to fund your sandbox wallets.
</Info>

***

## Pre-Populated Shared Sandbox Account

The shared sandbox account (accessible via the [public API key](/sandbox/overview)) already has:

| Asset    | Ticker    | Network       | Address                                        |
| -------- | --------- | ------------- | ---------------------------------------------- |
| USD Coin | USDC\_SOL | Solana Devnet | `GY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1` |