Assets & Wallets

Assets are wallets tied to a specific blockchain and token within an account. Each asset has a unique deposit address and tracks its own balance. You can add individual assets or batch-create many at once.

Get All Supported Assets

GET /assets/get-all-assets Returns the full list of chains and tokens available on the platform.

cURL

curl -X GET https://crypto-api.yativo.com/api/v1/assets/get-all-assets \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

{
  "data": [
    { "asset_name": "Binance Smart Chain", "asset_short_name": "BNB", "chain": "BSC", "chain_id": 56, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png", "active": true },
    { "asset_name": "XDC Network", "asset_short_name": "XDC", "chain": "XDC", "chain_id": 50, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/2912/large/xdc-icon.png", "active": true },
    { "asset_name": "Bitcoin", "asset_short_name": "BTC", "chain": "BTC", "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png", "active": true },
    { "asset_name": "Solana", "asset_short_name": "SOL", "chain": "SOL", "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/4128/large/solana.png", "active": true },
    { "asset_name": "Ethereum on Base", "asset_short_name": "ETH", "chain": "Base", "chain_id": 8453, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/279/large/ethereum.png", "active": true },
    { "asset_name": "Polygon", "asset_short_name": "POL", "chain": "POL", "chain_id": 137, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/32440/standard/pol.png", "active": true },
    { "asset_name": "Optimism", "asset_short_name": "OP", "chain": "OP", "chain_id": 156, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/25244/standard/Token.png", "active": true },
    { "asset_name": "Arbitrum", "asset_short_name": "ARB", "chain": "ARB", "chain_id": 84, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/16547/standard/arb.jpg", "active": true },
    { "asset_name": "Tron", "asset_short_name": "TRX", "chain": "TRON", "chain_id": 8, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/1094/standard/tron-logo.png", "active": true },
    { "asset_name": "Avalanche", "asset_short_name": "AVAX", "chain": "AVAX", "chain_id": 28, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/12559/standard/Avalanche_Circle_RedWhite_Trans.png", "active": true },
    { "asset_name": "Tether USD (Polygon)", "asset_short_name": "USDT", "chain": "POL", "chain_id": 137, "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/325/large/Tether.png", "active": true },
    { "asset_name": "USD Coin (Solana)", "asset_short_name": "USDC", "chain": "SOL", "network_type": "mainnet", "asset_type": "token", "token_standard": "SPL", "contract_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png", "active": true },
    { "asset_name": "EURO Coin", "asset_short_name": "EURC", "chain": "SOL", "network_type": "mainnet", "asset_type": "token", "token_standard": "SPL", "contract_address": "HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/26045/large/euro.png", "active": true },
    { "asset_name": "TIVO", "asset_short_name": "TIVO", "chain": "XDC", "network_type": "mainnet", "asset_type": "token", "token_standard": "XRC-20", "contract_address": "0x765087A2360F4D1F516De6552970256F9DB64827", "decimals": 18, "image": "https://tivotoken.com/wp-content/uploads/2024/11/Tivo-A2_040739-e1731947639142.png", "active": true },
    { "asset_name": "USD Coin (Polygon)", "asset_short_name": "USDC", "chain": "POL", "chain_id": 137, "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/6319/large/USD_Coin_icon.png", "active": true },
    { "asset_name": "Tether USD (Solana)", "asset_short_name": "USDT", "chain": "SOL", "network_type": "mainnet", "asset_type": "token", "token_standard": "SPL", "contract_address": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/325/large/Tether.png", "active": true },
    { "asset_name": "PayPal USD (PYUSD)", "asset_short_name": "PYUSD", "chain": "SOL", "network_type": "mainnet", "asset_type": "token", "token_standard": "SPL", "contract_address": "2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/31212/standard/PYUSD_Token_Logo_2x.png", "active": true },
    { "asset_name": "Global Dollar (USDG)", "asset_short_name": "USDG", "chain": "SOL", "network_type": "mainnet", "asset_type": "token", "token_standard": "SPL", "contract_address": "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/51281/standard/GDN_USDG_Token_200x200.png", "active": true },
    { "asset_name": "Bridged USDC (XDC)", "asset_short_name": "USDC", "chain": "XDC", "chain_id": 50, "network_type": "mainnet", "asset_type": "token", "token_standard": "XRC20", "contract_address": "0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1", "decimals": 6, "image": "https://xdcscan.com/token/images/usdc_ofc_32.svg", "active": true },
    { "asset_name": "Gnosis Chain (xDAI)", "asset_short_name": "xDAI", "chain": "GNO", "chain_id": 100, "network_type": "mainnet", "asset_type": "native", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/11062/standard/Identity-Primary-DarkBG.png", "active": true },
    { "asset_name": "Gnosis", "asset_short_name": "GNO", "chain": "GNO", "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0x9C58BAcC331c9aa871AFD802DB6228953991E8a0", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/662/standard/logo_square_simple_300px.png", "active": true },
    { "asset_name": "USD Coin Bridged (GNO)", "asset_short_name": "USDCe", "chain": "GNO", "chain_id": 100, "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0", "decimals": 6, "image": "https://assets.coingecko.com/coins/images/6319/standard/usdc.png", "active": true },
    { "asset_name": "Pound Sterling Bridged (GNO)", "asset_short_name": "GBPe", "chain": "GNO", "chain_id": 100, "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0x5Cb9073902F2035222B9749F8fB0c9BFe5527108", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/39004/standard/gbp.png", "active": true },
    { "asset_name": "Euro Bridged (GNO)", "asset_short_name": "EURe", "chain": "GNO", "chain_id": 100, "network_type": "mainnet", "asset_type": "token", "token_standard": "ERC20", "contract_address": "0x39b8B6385416f4cA36a20319F70D28621895279D", "decimals": 18, "image": "https://assets.coingecko.com/coins/images/23354/standard/eur.png?1696522569", "active": true }
  ],
  "status": true,
  "message": "Assets Listed Successfully"
}

Get Supported Chains

GET /assets/get-chains

cURL

curl -X GET https://crypto-api.yativo.com/api/v1/assets/get-chains \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Add an Asset

POST /assets/add-asset Creates a new wallet (deposit address) for a specific chain and token within an account.

string

required

The account this wallet belongs to.

string

required

The blockchain identifier (e.g., ethereum, solana). See Supported Chains.

string

required

The token ticker (e.g., USDC, SOL).

curl -X POST https://crypto-api.yativo.com/api/v1/assets/add-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01abc123",
    "chain": "ethereum",
    "ticker": "USDC"
  }'

const wallet = await client.assets.add({
  account_id: 'acc_01abc123',
  chain: 'ethereum',
  ticker: 'USDC',
});
console.log('Deposit address:', wallet.address);

wallet = client.assets.add(
    account_id='acc_01abc123',
    chain='ethereum',
    ticker='USDC',
)
print('Deposit address:', wallet['address'])

Response

{
  "id": "asset_01xyz789",
  "account_id": "acc_01abc123",
  "chain": "ethereum",
  "ticker": "USDC",
  "name": "USD Coin",
  "address": "0x742d35Cc6634C0532925a3b8D4C9C2A5Ef8C2B1",
  "balance": "0",
  "balance_usd": "0",
  "status": "active",
  "created_at": "2026-03-26T10:00:00Z"
}

Batch Add Assets

POST /assets/batch-add-asset Create multiple wallets in a single request. Useful when onboarding a new account that needs wallets across multiple chains.

string

required

The account these wallets will belong to.

array

required

Array of chain identifiers.

array

required

Array of token tickers. Each ticker is paired with the corresponding chain by index.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/assets/batch-add-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01abc123",
    "chains": ["ethereum", "solana", "polygon"],
    "tickers": ["USDC", "USDC_SOL", "USDC_POLYGON"]
  }'

Response

{
  "created": [
    {
      "id": "asset_01a",
      "chain": "ethereum",
      "ticker": "USDC",
      "address": "0x742d35Cc6634C0532925a3b8D4C9C2A5Ef8C2B1"
    },
    {
      "id": "asset_02b",
      "chain": "solana",
      "ticker": "USDC_SOL",
      "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
    },
    {
      "id": "asset_03c",
      "chain": "polygon",
      "ticker": "USDC_POLYGON",
      "address": "0x8A7c4f2E9B1D3A6C5E0F7B2D4A9C8E1F3B5D7A9"
    }
  ]
}

Get User Assets

POST /assets/get-user-assets Returns all assets (wallets) for the authenticated user, or filtered by account.

string

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

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/assets/get-user-assets \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "acc_01abc123"}'

Response

{
  "assets": [
    {
      "id": "asset_01xyz789",
      "account_id": "acc_01abc123",
      "chain": "ethereum",
      "ticker": "USDC",
      "address": "0x742d35Cc6634C0532925a3b8D4C9C2A5Ef8C2B1",
      "balance": "500.00",
      "balance_usd": "500.00",
      "status": "active"
    }
  ]
}

Check Balance

POST /balance/check Returns the current balance for a specific asset.

string

required

The asset ID to check the balance for.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/balance/check \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"asset_id": "asset_01xyz789"}'

Response

{
  "asset_id": "asset_01xyz789",
  "chain": "ethereum",
  "ticker": "USDC",
  "address": "0x742d35Cc6634C0532925a3b8D4C9C2A5Ef8C2B1",
  "balance": "500.00",
  "balance_usd": "500.00",
  "last_updated": "2026-03-26T10:05:00Z"
}

Archive an Asset

POST /assets/archive-asset Deactivates a wallet. The address remains valid for receiving funds, but the asset will no longer appear in active asset lists.

string

required

The ID of the asset to archive.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/assets/archive-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"asset_id": "asset_01xyz789"}'

Add Customer Asset

POST /assets/add-customer-asset Create a wallet for a specific B2B customer. See Customers for context on the customer model.

string

required

The customer ID to create the wallet for.

string

required

Blockchain identifier.

string

required

Token ticker.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/assets/add-customer-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_01abc",
    "chain": "solana",
    "ticker": "USDC_SOL"
  }'

Get Customer Assets

POST /assets/get-customer-assets Returns all wallets for a B2B customer.

string

Filter by customer. If omitted, returns assets for all customers.

cURL

curl -X POST https://crypto-api.yativo.com/api/v1/assets/get-customer-assets \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "cust_01abc"}'

Supported Chains & Tickers Reference

Chain	Native	Stablecoins
Ethereum	`ETH`	`USDC`, `USDT`, `DAI`
Solana	`SOL`	`USDC_SOL`, `USDT_SOL`
Bitcoin	`BTC`	—
Polygon	`POL`	`USDC_POLYGON`, `USDT_POLYGON`
BSC	`BNB`	`USDC_BSC`, `USDT_BSC`
Base	`ETH_BASE`	`USDC_BASE`
Arbitrum	`ETH_ARBITRUM`	`USDC_ARBITRUM`, `USDT_ARBITRUM`
Optimism	`ETH_OPTIMISM`	`USDC_OPTIMISM`, `USDT_OPTIMISM`
XDC	`XDC`	`USDC_XDC`, `USDT_XDC`

Deposit addresses are chain-specific. Never send a token to an address on the wrong chain — funds sent to the wrong network cannot be automatically recovered.

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Assets & Wallets

Get All Supported Assets

Get Supported Chains

Add an Asset

Batch Add Assets

Get User Assets

Check Balance

Archive an Asset

Add Customer Asset

Get Customer Assets

Supported Chains & Tickers Reference

​Get All Supported Assets

​Get Supported Chains

​Add an Asset

​Batch Add Assets

​Get User Assets

​Check Balance

​Archive an Asset

​Add Customer Asset

​Get Customer Assets

​Supported Chains & Tickers Reference

Get All Supported Assets

Get Supported Chains

Add an Asset

Batch Add Assets

Get User Assets

Check Balance

Archive an Asset

Add Customer Asset

Get Customer Assets

Supported Chains & Tickers Reference