> ## 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.

# Assets & Wallets

> Add and manage crypto wallets for specific chains and tokens

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.

```bash cURL theme={null}
curl -X GET https://crypto-api.yativo.com/api/v1/assets/get-all-assets \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

```json Response theme={null}
{
  "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`

```bash cURL theme={null}
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.

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

<ParamField body="chain" type="string" required>
  The blockchain identifier (e.g., `ethereum`, `solana`). See [Supported Chains](/yativo-crypto/supported-chains).
</ParamField>

<ParamField body="ticker" type="string" required>
  The token ticker (e.g., `USDC`, `SOL`).
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

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

  ```python Python theme={null}
  wallet = client.assets.add(
      account_id='acc_01abc123',
      chain='ethereum',
      ticker='USDC',
  )
  print('Deposit address:', wallet['address'])
  ```
</CodeGroup>

```json Response theme={null}
{
  "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.

<ParamField body="account_id" type="string" required>
  The account these wallets will belong to.
</ParamField>

<ParamField body="chains" type="array" required>
  Array of chain identifiers.
</ParamField>

<ParamField body="tickers" type="array" required>
  Array of token tickers. Each ticker is paired with the corresponding chain by index.
</ParamField>

```bash cURL theme={null}
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"]
  }'
```

```json Response theme={null}
{
  "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.

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

```bash cURL theme={null}
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"}'
```

```json Response theme={null}
{
  "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.

<ParamField body="asset_id" type="string" required>
  The asset ID to check the balance for.
</ParamField>

```bash cURL theme={null}
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"}'
```

```json Response theme={null}
{
  "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.

<ParamField body="asset_id" type="string" required>
  The ID of the asset to archive.
</ParamField>

```bash cURL theme={null}
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](/yativo-crypto/customers) for context on the customer model.

<ParamField body="customer_id" type="string" required>
  The customer ID to create the wallet for.
</ParamField>

<ParamField body="chain" type="string" required>
  Blockchain identifier.
</ParamField>

<ParamField body="ticker" type="string" required>
  Token ticker.
</ParamField>

```bash cURL theme={null}
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.

<ParamField body="customer_id" type="string">
  Filter by customer. If omitted, returns assets for all customers.
</ParamField>

```bash cURL theme={null}
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`           |

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