Skip to main content

​
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/
You must be authenticated with a sandbox access token before calling these endpoints. See Sandbox Authentication to obtain a token.

​
Step 1 — Create an Account

Accounts are containers for your wallets and assets. 
POST https://crypto-sandbox.yativo.com/api/accounts/create-account
cURL
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 Main",
    "account_type": "business"
  }'
Response
{
  "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/assets/add-asset
​
account_id
string
required
The account to add the wallet to.
​
chain
string
required
Blockchain network: solana, ethereum, bitcoin, polygon, bsc, base, xdc.
​
ticker
string
required
Token ticker symbol: USDC_SOL, ETH, BTC, USDC_ETH, BNB, etc.
curl -X POST 'https://crypto-sandbox.yativo.com/api/assets/add-asset' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "chain": "solana",
    "ticker": "USDC_SOL"
  }'
Response
{
  "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"
  }
}
The wallet_address is your deposit address for this asset on the testnet. Use a testnet faucet to fund it.

​
Step 3 — List Your Assets

Retrieve all wallets and their balances. 
POST https://crypto-sandbox.yativo.com/api/assets/get-user-assets
​
account_id
string
Filter by a specific account. If omitted, returns all assets across all accounts.
cURL
curl -X POST 'https://crypto-sandbox.yativo.com/api/assets/get-user-assets' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "acc_01HX9KZMB3F7VNQP8R2WDGT4E5"
  }'
Response
{
  "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/accounts/get-accounts
cURL
curl -X GET 'https://crypto-sandbox.yativo.com/api/accounts/get-accounts' \
  -H 'Authorization: Bearer YOUR_SANDBOX_TOKEN'
Response
{
  "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

NetworkTestnet UsedFaucet
SolanaDevnetfaucet.solana.com
Ethereum / BaseSepoliasepoliafaucet.com
GnosisChiadofaucets.buildwithsygma.com
PolygonAmoyPolygon faucet
BNB ChainBSC TestnetBNB testnet faucet
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.

​
Pre-Populated Shared Sandbox Account

The shared sandbox account (accessible via the public API key) already has:
AssetTickerNetworkAddress
USD CoinUSDC_SOLSolana DevnetGY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1