Test: Wallets & Assets

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/

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/v1/accounts/create-account

cURL

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"
  }'

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/v1/assets/add-asset

string

required

The account to add the wallet to.

string

required

Blockchain network: solana, ethereum, bitcoin, polygon, bsc, base, xdc.

string

required

Token ticker symbol: USDC_SOL, ETH, BTC, USDC_ETH, BNB, etc.

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"
  }'

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"
  }'

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/v1/assets/get-user-assets

string

Filter by a specific account. If omitted, returns all assets across all accounts.

cURL

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"
  }'

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/v1/accounts/get-accounts

cURL

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

Network	Testnet Used	Faucet
Solana	Devnet	faucet.solana.com
Ethereum / Base	Sepolia	sepoliafaucet.com
Gnosis	Chiado	faucets.buildwithsygma.com
Polygon	Amoy	Polygon faucet
BNB Chain	BSC Testnet	BNB 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:

Asset	Ticker	Network	Address
USD Coin	USDC_SOL	Solana Devnet	`GY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1`

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Test: Wallets & Assets

Overview

Step 1 — Create an Account

Step 2 — Add a Wallet (Asset)

Step 3 — List Your Assets

Step 4 — List Accounts

Available Testnet Networks

Pre-Populated Shared Sandbox Account

​Overview

​Step 1 — Create an Account

​Step 2 — Add a Wallet (Asset)

​Step 3 — List Your Assets

​Step 4 — List Accounts

​Available Testnet Networks

​Pre-Populated Shared Sandbox Account

Overview

Step 1 — Create an Account

Step 2 — Add a Wallet (Asset)

Step 3 — List Your Assets

Step 4 — List Accounts

Available Testnet Networks

Pre-Populated Shared Sandbox Account