Quick Start

Prerequisites: You’ll need a NEAR wallet and some NEAR tokens. If you’re new to NEAR Protocol, visit wallet.near.org to create one.

Start Trading in 3 Steps

Connect Your Wallet

Visit app.vita.finance and click “Connect Wallet”

Vita Finance supports 23 different wallets including NEAR Wallet, Meteor, Sender, MetaMask, Ledger, and many more.

# Using NEAR CLI
near login

Select Tokens to Swap

Choose your input and output tokens from our supported list

Popular Pairs
All Tokens

NEAR ↔ USDC - High volume
NEAR ↔ VITA - Protocol token
VITA ↔ xVITA - Staking conversion
USDC ↔ USDT - Stable swap

Remember decimal differences:

NEAR: 24 decimals
VITA/xVITA: 18 decimals
USDC/USDT: 6 decimals

Execute Your Swap

Enter the amount, review the details, and confirm

Always check the price impact and minimum received amount before confirming. Default swap fee is 0.3%.

Trading Options

Vita uses an Automated Market Maker (AMM) with concentrated liquidity for optimal pricing and instant swaps. We also offer a Central Limit Order Book (CLOB) for advanced traders.

AMM Swaps

Instant token swaps with concentrated liquidity:

Best prices through smart routing
Minimal slippage on popular pairs
Default 0.3% trading fee
Instant execution

Try AMM Swap

Instant token exchange

Your First Liquidity Position

Ready to earn fees? Here’s how to provide liquidity:

1. Choose a Pool

Browse available pools and select one based on:

Volume: Higher volume = more fees
Your tokens: What you hold

2. Set Your Price Range

Concentrated liquidity lets you choose where to deploy capital:

// Example ranges for NEAR/USDC (assuming current price: $5)
const ranges = {
  narrow: { min: 4.90, max: 5.10 }, // ±2% - Higher fees, more management
  medium: { min: 4.50, max: 5.50 }, // ±10% - Balanced approach
  wide: { min: 3.00, max: 8.00 }    // ±40% - Lower fees, less management
};

// Valid tick range: -665454 to 831818

3. Deposit and Mint NFT

Add your tokens and receive an NFT representing your position

# Mint position directly via CLI
near call [TBD] mint_position \
  '{
    "pool_id": "NEAR-USDC",
    "tick_lower_index": -10986,
    "tick_upper_index": 9183,
    "amount0_desired": "1000000000000000000000000",
    "amount1_desired": "5000000",
    "amount0_min": "990000000000000000000000",
    "amount1_min": "4950000"
  }' \
  --accountId your-wallet.near \
  --amount 0.1

// Direct contract call
const contract = new Contract(
  account,
  "[TBD]", // Contract address
  {
    changeMethods: ["mint_position"],
  }
);

await contract.mint_position({
  pool_id: "NEAR-USDC",
  tick_lower_index: -10986,    // Lower tick
  tick_upper_index: 9183,       // Upper tick
  amount0_desired: "1000000000000000000000000", // 1 NEAR (24 decimals)
  amount1_desired: "5000000",   // 5 USDC (6 decimals)
  amount0_min: "990000000000000000000000",
  amount1_min: "4950000"
});

Stake VITA for xVITA

Why Stake?

xVITA holders earn protocol revenue from AMM trading fees, plus boost multipliers up to 2.5x

Quick Staking Guide

# 1. Convert VITA to xVITA using ft_transfer_call
near call [TBD] ft_transfer_call \
  '{"receiver_id": "[TBD]", "amount": "1000000000000000000", "msg": "{\"convert\": {}}"}' \
  --accountId your-wallet.near \
  --amount 0.000000000000000000000001

# 2. Check your xVITA balance (18 decimals)
near view [TBD] ft_balance_of \
  '{"account_id": "your-wallet.near"}'

# 3. View staking info
near view [TBD] get_user_staking_info \
  '{"account_id": "your-wallet.near"}'

Redemption Options

Instant Redeem
Standard Redeem
Max Redeem

Period: 15 days
Return: 50% of VITA (penalty)
Use case: Need liquidity quickly

Common Actions

Check Token Balances

near view [TBD] ft_balance_of \
  '{"account_id": "your-wallet.near"}'
# Returns: "1000000000000000000" (1 VITA with 18 decimals)

near view [TBD] ft_balance_of \
  '{"account_id": "your-wallet.near"}'
# Returns: "500000000000000000" (0.5 xVITA with 18 decimals)

near state your-wallet.near
# Shows total NEAR balance in the account

Monitor Your Positions

# Get all your NFT position IDs
near view [TBD] get_user_positions \
  '{"account_id": "your-wallet.near"}'

# Get specific position details
near view [TBD] get_position \
  '{"token_id": "12345"}'

# Check accumulated fees
near view [TBD] get_unclaimed_fee \
  '{"position_id": "12345"}'

Claim Rewards

Check Claimable Rewards

near view [TBD] get_unclaimed_rewards \
  '{"account_id": "your-wallet.near", "session_id": 42}'

near view [TBD] get_farming_rewards \
  '{"account_id": "your-wallet.near"}'

Claim Your Rewards

near call [TBD] claim_all_rewards \
  '{}' \
  --accountId your-wallet.near \
  --amount 0.01

near call [TBD] claim_session_rewards \
  '{"session_id": 42}' \
  --accountId your-wallet.near \
  --amount 0.01

Helpful Resources

Discord Community

Get help from the community

API Documentation

Complete contract reference

Example Scripts

Ready-to-use code examples

Video Tutorials

Step-by-step video guides

Common Issues & Solutions

Transaction Failed

Common causes and solutions:

Insufficient gas: Attach at least 0.1 NEAR for complex operations
Slippage too low: Increase slippage tolerance in settings
Price moved: Refresh and try again with updated prices

Can't See My Position

Check these common issues:

Ensure you’re connected with the correct wallet
Positions are NFTs - check your NFT tab
Use the CLI commands above to verify

Decimal Confusion

NEAR: 24 decimals
1 NEAR = 1000000000000000000000000VITA/xVITA: 18 decimals
1 VITA = 1000000000000000000USDC/USDT: 6 decimals
1 USDC = 1000000

What’s Next?

Continue Your Journey

For Traders

Explore trading strategies
Learn about limit orders
Master order types

For Liquidity Providers

Pro tip: Start small with wide ranges to get familiar with the system, then gradually narrow your ranges as you gain experience.

Getting Started

Trading

Governance

Start Trading in 3 Steps

Trading Options

AMM Swaps

Try AMM Swap

Your First Liquidity Position

Stake VITA for xVITA

Why Stake?

Quick Staking Guide

Redemption Options

Common Actions

Check Token Balances

Monitor Your Positions

Claim Rewards

Helpful Resources

Discord Community

API Documentation

Example Scripts

Video Tutorials

Common Issues & Solutions

What’s Next?

Continue Your Journey

​Start Trading in 3 Steps

​Trading Options

​AMM Swaps

Try AMM Swap

​Your First Liquidity Position

​Stake VITA for xVITA

Why Stake?

​Quick Staking Guide

​Redemption Options

​Common Actions

​Check Token Balances

​Monitor Your Positions

​Claim Rewards

​Helpful Resources

Discord Community

API Documentation

Example Scripts

Video Tutorials

​Common Issues & Solutions

​What’s Next?

​Continue Your Journey

Start Trading in 3 Steps

Trading Options

AMM Swaps

Your First Liquidity Position

Stake VITA for xVITA

Quick Staking Guide

Redemption Options

Common Actions

Check Token Balances

Monitor Your Positions

Claim Rewards

Helpful Resources

Common Issues & Solutions

What’s Next?

Continue Your Journey