Assets
Assets represent the native currency and tokens held by your vaults. The Assets API enables you to discover balances, refresh data, manage vault asset lists, and retrieve token metadata.
What are Assets?
Assets in Cubewire include:
- Native Currency — Blockchain's native token (ETH, MATIC, etc.)
- ERC-20 Tokens — Fungible tokens (USDC, USDT, DAI, etc.)
- Vault Asset List — Curated set of assets tracked per vault
Asset Balance Flow
Common Use Cases
Balance Dashboards
- Discover and display vault balances across networks
- Refresh balances before displaying or making decisions
- Build portfolio views for multiple vaults
Token Management
- Add tokens to vault tracking for visibility
- Retrieve token metadata (symbol, decimals) for display
- Update or remove assets from vault watchlists
Pre-Transaction Validation
- Check native and token balances before submitting transfers
- Ensure sufficient balance for gas and transfer amount
Best Practices
| Practice | Description |
|---|---|
| Refresh before display | Balances can become stale; refresh when accuracy matters |
| Cache token info | Token metadata changes rarely; cache symbol/decimals |
| Manage vault assets | Add only assets you need to track for each vault |
Related Topics
- Vaults — Vaults hold the assets
- Transactions — Transfer assets between addresses
- Networks — Networks define available assets
API Reference
For complete API documentation including endpoints, request/response examples, and code samples:
- Discover asset balances —
POST /api/v1/assets/balance/discover - Get native currency balance —
POST /api/v1/assets/balance/native - Refresh asset balances —
POST /api/v1/assets/balance/refresh - Get token balance —
POST /api/v1/assets/balance/token - Get token info —
POST /api/v1/assets/token-info - Get vault assets —
GET /api/v1/assets/vaults/{vaultId}/assets - Add asset to vault —
POST /api/v1/assets/vaults/{vaultId}/assets - Get asset details —
GET /api/v1/assets/vaults/{vaultId}/assets/{assetId} - Update asset —
PATCH /api/v1/assets/vaults/{vaultId}/assets/{assetId} - Delete asset —
DELETE /api/v1/assets/vaults/{vaultId}/assets/{assetId}
Assets
Assets represent the native currency and tokens held by your vaults. The Assets API enables you to discover balances, refresh data, manage vault asset lists, and retrieve token metadata.
What are Assets?
Assets in Cubewire include:
- Native Currency — Blockchain's native token (ETH, MATIC, etc.)
- ERC-20 Tokens — Fungible tokens (USDC, USDT, DAI, etc.)
- Vault Asset List — Curated set of assets tracked per vault
Asset Balance Flow
Common Use Cases
Balance Dashboards
- Discover and display vault balances across networks
- Refresh balances before displaying or making decisions
- Build portfolio views for multiple vaults
Token Management
- Add tokens to vault tracking for visibility
- Retrieve token metadata (symbol, decimals) for display
- Update or remove assets from vault watchlists
Pre-Transaction Validation
- Check native and token balances before submitting transfers
- Ensure sufficient balance for gas and transfer amount
Best Practices
| Practice | Description |
|---|---|
| Refresh before display | Balances can become stale; refresh when accuracy matters |
| Cache token info | Token metadata changes rarely; cache symbol/decimals |
| Manage vault assets | Add only assets you need to track for each vault |
Related Topics
- Vaults — Vaults hold the assets
- Transactions — Transfer assets between addresses
- Networks — Networks define available assets
API Reference
For complete API documentation including endpoints, request/response examples, and code samples:
- Discover asset balances —
POST /api/v1/assets/balance/discover - Get native currency balance —
POST /api/v1/assets/balance/native - Refresh asset balances —
POST /api/v1/assets/balance/refresh - Get token balance —
POST /api/v1/assets/balance/token - Get token info —
POST /api/v1/assets/token-info - Get vault assets —
GET /api/v1/assets/vaults/{vaultId}/assets - Add asset to vault —
POST /api/v1/assets/vaults/{vaultId}/assets - Get asset details —
GET /api/v1/assets/vaults/{vaultId}/assets/{assetId} - Update asset —
PATCH /api/v1/assets/vaults/{vaultId}/assets/{assetId} - Delete asset —
DELETE /api/v1/assets/vaults/{vaultId}/assets/{assetId}