Wallet Operations - Monei API

Overview

Your Monei Solana wallet allows you to manage SOL and SPL tokens on the Solana blockchain. This guide covers wallet operations, balance management, and portfolio tracking. What you’ll learn:

Get Solana wallet address
Check SOL balance
Check SPL token balances
View complete portfolio
Send SOL and SPL tokens
Network selection (mainnet/devnet/testnet)

Your Solana Wallet

Fast Transactions

~0.4 second block time, near-instant finality

Low Fees

~$0.00025 per transaction

Custodial

Monei securely manages your private keys

Get Wallet Address

Retrieve your Solana wallet address.

import MoneiSDK from 'monei-sdk';

const monei = new MoneiSDK({
  apiKey: process.env.MONEI_API_KEY,
});

// Get Solana wallet address
const address = await monei.solana.getAddress();

console.log('Solana Address:', address.address);

from monei import MoneiClient

monei = MoneiClient(
    api_key=os.getenv('MONEI_API_KEY')
)

# Get Solana address
address = monei.solana.get_address()

print(f'Solana Address: {address.address}')

curl https://api.monei.cc/api/v1/solana/address \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "statusCode": 200,
  "message": "Address retrieved successfully",
  "data": {
    "address": "7KX8kq1vXWBYGNHWD3HqLNcJ6J6xWN5N3J6J6J6J6J6J"
  }
}

Network Selection

Solana supports multiple networks for different use cases.

Network	Description	Use Case
`mainnet-beta`	Production network	Real transactions
`devnet`	Development network	Testing
`testnet`	Testing network	Testing

// Get balance on mainnet (default)
const mainnetBalance = await monei.solana.getNativeBalance({
  network: 'mainnet-beta'
});

// Get balance on devnet for testing
const devnetBalance = await monei.solana.getNativeBalance({
  network: 'devnet'
});

console.log('Mainnet Balance:', mainnetBalance.balance, 'SOL');
console.log('Devnet Balance:', devnetBalance.balance, 'SOL');

# Mainnet balance
mainnet_balance = monei.solana.get_native_balance(network='mainnet-beta')

# Devnet balance
devnet_balance = monei.solana.get_native_balance(network='devnet')

print(f'Mainnet: {mainnet_balance.balance} SOL')
print(f'Devnet: {devnet_balance.balance} SOL')

Default network is mainnet-beta. Specify network parameter for devnet or testnet.

Get SOL Balance

Check your native SOL balance.

// Get SOL balance
const balance = await monei.solana.getNativeBalance({
  network: 'mainnet-beta' // optional, defaults to mainnet-beta
});

console.log('SOL Balance:', balance.balance);
console.log('In Lamports:', balance.balanceLamports);

# Get SOL balance
balance = monei.solana.get_native_balance(network='mainnet-beta')

print(f'SOL Balance: {balance.balance}')
print(f'In Lamports: {balance.balance_lamports}')

curl "https://api.monei.cc/api/v1/solana/balance?network=mainnet-beta" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "statusCode": 200,
  "message": "Balance retrieved successfully",
  "data": {
    "balance": "2.5"
  }
}

1 SOL = 1,000,000,000 lamports (9 decimals)

Get SPL Token Balance

Check balance for a specific SPL token.

// Get USDC balance on Solana
const usdcBalance = await monei.solana.getTokenBalance({
  tokenMintAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC mint
  network: 'mainnet-beta'
});

console.log('USDC Balance:', usdcBalance.balance);

// Get USDT balance
const usdtBalance = await monei.solana.getTokenBalance({
  tokenMintAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB', // USDT mint
  network: 'mainnet-beta'
});

console.log('USDT Balance:', usdtBalance.balance);

# Get USDC balance
usdc_balance = monei.solana.get_token_balance(
    token_mint_address='EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    network='mainnet-beta'
)

print(f'USDC Balance: {usdc_balance.balance}')

# Get USDT balance
usdt_balance = monei.solana.get_token_balance(
    token_mint_address='Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
    network='mainnet-beta'
)

print(f'USDT Balance: {usdt_balance.balance}')

# Get USDC balance
curl "https://api.monei.cc/api/v1/solana/token-balance/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?network=mainnet-beta" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "statusCode": 200,
  "message": "Token balance retrieved successfully",
  "data": {
    "balance": "1500.50"
  }
}

Get Portfolio

View your complete Solana portfolio including SOL and all SPL tokens.

// Get complete portfolio
const portfolio = await monei.solana.getPortfolio({
  network: 'mainnet-beta'
});

console.log('User ID:', portfolio.userId);
console.log('Address:', portfolio.address);
console.log('Total Value:', portfolio.totalValueUsd, 'USD');

// Native SOL
console.log('\nNative SOL:');
console.log('  Balance:', portfolio.nativeBalance, 'SOL');
console.log('  Lamports:', portfolio.nativeBalanceLamports);
console.log('  USD Value:', portfolio.nativeBalanceUsd);

// SPL Tokens
console.log('\nSPL Tokens:');
portfolio.tokens.forEach(token => {
  console.log(`\n  ${token.symbol} (${token.name})`);
  console.log(`    Mint: ${token.mintAddress}`);
  console.log(`    Balance: ${token.balance}`);
  console.log(`    Raw Balance: ${token.rawBalance}`);
  console.log(`    Decimals: ${token.decimals}`);
  console.log(`    Price USD: $${token.priceUsd}`);
  console.log(`    Value USD: $${token.valueUsd}`);
});

# Get portfolio
portfolio = monei.solana.get_portfolio(network='mainnet-beta')

print(f'User ID: {portfolio.user_id}')
print(f'Address: {portfolio.address}')
print(f'Total Value: ${portfolio.total_value_usd}')

# Native SOL
print(f'\nNative SOL:')
print(f'  Balance: {portfolio.native_balance} SOL')
print(f'  Lamports: {portfolio.native_balance_lamports}')
print(f'  USD Value: ${portfolio.native_balance_usd}')

# SPL Tokens
print('\nSPL Tokens:')
for token in portfolio.tokens:
    print(f'\n  {token.symbol} ({token.name})')
    print(f'    Mint: {token.mint_address}')
    print(f'    Balance: {token.balance}')
    print(f'    Price: ${token.price_usd}')
    print(f'    Value: ${token.value_usd}')

curl "https://api.monei.cc/api/v1/solana/portfolio?network=mainnet-beta" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "statusCode": 200,
  "message": "Portfolio retrieved successfully",
  "data": {
    "userId": "user-uuid-here",
    "address": "7KX8kq1vXWBYGNHWD3HqLNcJ6J6xWN5N3J6J6J6J6J6J",
    "nativeBalance": "2.5",
    "nativeBalanceLamports": "2500000000",
    "nativeBalanceUsd": 250.0,
    "tokens": [
      {
        "mintAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "name": "USD Coin",
        "symbol": "USDC",
        "balance": "1500.50",
        "rawBalance": "1500500000",
        "decimals": 6,
        "priceUsd": 1.00,
        "valueUsd": 1500.50
      },
      {
        "mintAddress": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
        "name": "USDT",
        "symbol": "USDT",
        "balance": "500.00",
        "rawBalance": "500000000",
        "decimals": 6,
        "priceUsd": 1.00,
        "valueUsd": 500.00
      }
    ],
    "totalValueUsd": 2250.50
  }
}

Send SOL

Transfer SOL to another Solana address.

// Send 0.5 SOL
const tx = await monei.solana.sendNativeToken({
  to: '9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
  amount: '0.5',
  network: 'mainnet-beta'
});

console.log('Transaction Signature:', tx.signature);
console.log('View on Solscan:', `https://solscan.io/tx/${tx.signature}`);

// Wait for confirmation
await monei.solana.waitForConfirmation(tx.signature);
console.log('Transaction confirmed!');

# Send SOL
tx = monei.solana.send_native_token(
    to='9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
    amount='0.5',
    network='mainnet-beta'
)

print(f'Signature: {tx.signature}')
print(f'Explorer: https://solscan.io/tx/{tx.signature}')

# Wait for confirmation
monei.solana.wait_for_confirmation(tx.signature)
print('Confirmed!')

curl -X POST https://api.monei.cc/api/v1/solana/transfer \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g",
    "amount": "0.5",
    "network": "mainnet-beta"
  }'

Response:

{
  "statusCode": 200,
  "message": "Transfer successful",
  "data": {
    "signature": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnTPLgTLpjvS3yJG3TBhVLiYt5mMXe4EH7zJ2VSkQfpYjG"
  }
}

Request Parameters:

Parameter	Type	Required	Description
`to`	string	Yes	Recipient Solana address
`amount`	string	Yes	Amount of SOL to send
`network`	string	No	Network (default: mainnet-beta)

Send SPL Token

Transfer SPL tokens to another address.

// Send 100 USDC
const tx = await monei.solana.sendToken({
  to: '9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
  tokenMintAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  amount: '100',
  network: 'mainnet-beta'
});

console.log('Transaction Signature:', tx.signature);
console.log('View on Solscan:', `https://solscan.io/tx/${tx.signature}`);

// Send USDT
const usdtTx = await monei.solana.sendToken({
  to: '9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
  tokenMintAddress: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB', // USDT
  amount: '50',
  network: 'mainnet-beta'
});

console.log('USDT Transaction:', usdtTx.signature);

# Send USDC
tx = monei.solana.send_token(
    to='9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
    token_mint_address='EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    amount='100',
    network='mainnet-beta'
)

print(f'Signature: {tx.signature}')
print(f'Explorer: https://solscan.io/tx/{tx.signature}')

# Send USDT
usdt_tx = monei.solana.send_token(
    to='9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g',
    token_mint_address='Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
    amount='50',
    network='mainnet-beta'
)

print(f'USDT Transaction: {usdt_tx.signature}')

curl -X POST https://api.monei.cc/api/v1/solana/transfer-token \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g",
    "tokenMintAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "100",
    "network": "mainnet-beta"
  }'

Response:

{
  "statusCode": 200,
  "message": "Token transfer successful",
  "data": {
    "signature": "3yKGPvn2mVTpVqKLh9nWxkqVZL9RHkP2Uh8N5GqYqR7rRqKJ3sVHnT8LJ5VYqR7rRqKJ3sVHnT8LJ5VYqR7rR"
  }
}

Request Parameters:

Parameter	Type	Required	Description
`to`	string	Yes	Recipient Solana address
`tokenMintAddress`	string	Yes	SPL token mint address
`amount`	string	Yes	Amount of tokens to send
`network`	string	No	Network (default: mainnet-beta)

Common SPL Token Addresses

Stablecoins

Token	Mint Address
USDC	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
USDT	`Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB`
PYUSD	`2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo`

Wrapped Assets

Token	Mint Address
Wrapped SOL	`So11111111111111111111111111111111111111112`
Wrapped BTC	`9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9E`
Wrapped ETH	`7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs`

Popular Tokens

Token	Mint Address
JUP (Jupiter)	`JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN`
BONK	`DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263`
WIF	`EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm`

Always verify token mint addresses from official sources before using them.

Transaction Fees

Solana has extremely low transaction fees:

Transaction Type	Fee (SOL)	Fee (USD)
SOL Transfer	~0.000005	~$0.0005
SPL Token Transfer	~0.000005	~$0.0005
Token Swap	~0.00001	~$0.001

Fee Structure:

Base fee: 5,000 lamports (0.000005 SOL)
Priority fees: Optional, for faster processing
Rent: Required for new token accounts (~0.002 SOL, refundable)

// Check if recipient has token account
async function checkTokenAccount(recipientAddress, tokenMint) {
  try {
    const balance = await connection.getTokenAccountBalance(tokenMint);
    console.log('Token account exists');
    return true;
  } catch (error) {
    console.log('Token account does not exist');
    console.log('Will require rent: ~0.002 SOL');
    return false;
  }
}

# Estimate total cost
def estimate_transfer_cost(has_token_account=True):
    base_fee = 0.000005  # SOL
    rent = 0.002 if not has_token_account else 0  # SOL
    total = base_fee + rent
    
    print(f'Base Fee: {base_fee} SOL')
    if rent > 0:
        print(f'Rent (new account): {rent} SOL')
    print(f'Total Cost: {total} SOL')
    
    return total

Best Practices

Verify Addresses

Always verify recipient addresses before sending

Keep SOL for Fees

Maintain minimum 0.01 SOL for transaction fees

Test Small First

Send small test amount before large transfers

Check Token Accounts

Ensure recipient has token account to avoid rent

Monitor Portfolio

Regularly check portfolio for all holdings

Use Mainnet

Always use mainnet-beta for real transactions

Solana vs EVM Comparison

Feature	Solana	EVM (Ethereum, BSC, etc.)
Block Time	~0.4 seconds	2-15 seconds
Transaction Fee	~$0.0005	$0.01 -$ 50
Finality	~1 second	30 seconds - 3 minutes
TPS	65,000+	15 - 2,000
Address Format	Base58 (44 chars)	Hex (42 chars, 0x…)
Tokens	SPL tokens	ERC-20 tokens
Use Case	High-speed, low-cost	General purpose, DeFi

Troubleshooting

Transaction Failed - Insufficient Balance

Error: Insufficient balance for transactionCommon causes:

Not enough SOL for amount + fees
Not enough token balance
Need rent for new token account (~0.002 SOL)

Solution:

// Check balance before sending
const balance = await monei.solana.getBalance({ network: 'mainnet-beta' });
const minRequired = parseFloat(amount) + 0.01; // amount + buffer

if (parseFloat(balance.balance) < minRequired) {
  console.log('Insufficient SOL balance');
  console.log('Need:', minRequired, 'SOL');
  console.log('Have:', balance.balance, 'SOL');
}

Token Account Does Not Exist

Error: Recipient token account not foundCause: Recipient has never received this token beforeSolution:

First transfer will create token account (costs ~0.002 SOL rent)
Rent is paid by sender
Ensure you have extra SOL for rent
Recipient can close account later to reclaim rent

Transaction Pending

Problem: Transaction not confirmingExpected confirmation time: ~1 secondAction:

Check transaction on Solscan/Solana Explorer
Wait up to 30 seconds
If still pending, check network status
Contact support if pending > 1 minute

Invalid Address Format

Error: Invalid Solana addressValid format:

Base58 encoded
32-44 characters
Example: 9B5XszUGdMaxCZ7uSQhPzdks5ZQSmWxrmzCSvtJ6Ns6g

Validation:

function isValidSolanaAddress(address) {
  return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);
}

if (!isValidSolanaAddress(recipientAddress)) {
  console.log('Invalid Solana address format');
}

Blockhash Not Found

Error: Blockhash not found or expiredCause: Transaction took too long to processSolution:

Transactions on Solana expire after ~60 seconds
Retry the transaction
This is handled automatically by Monei

Next Steps

Transactions

Learn about Solana transaction management

Token Swaps

Swap SOL and SPL tokens on Jupiter

EVM Wallet

Compare with EVM wallet operations

Networks

Learn about supported networks

​Overview

​Your Solana Wallet

Fast Transactions

Low Fees

Custodial

​Get Wallet Address

​Network Selection

​Get SOL Balance

​Get SPL Token Balance

​Get Portfolio

​Send SOL

​Send SPL Token

​Common SPL Token Addresses

​Stablecoins

​Wrapped Assets

​Popular Tokens

​Transaction Fees

​Best Practices

Verify Addresses

Keep SOL for Fees

Test Small First

Check Token Accounts

Monitor Portfolio

Use Mainnet

​Solana vs EVM Comparison

​Troubleshooting

​Next Steps

Transactions

Token Swaps

EVM Wallet

Networks

Overview

Your Solana Wallet

Get Wallet Address

Network Selection

Get SOL Balance

Get SPL Token Balance

Get Portfolio

Send SOL

Send SPL Token

Common SPL Token Addresses

Stablecoins

Wrapped Assets

Popular Tokens

Transaction Fees

Best Practices

Solana vs EVM Comparison

Troubleshooting

Next Steps