Wallet Data Overview

Why Wallet Intelligence Matters

Understanding what's inside a wallet is fundamental to nearly every Solana application. Whether you're building a portfolio tracker, analyzing whale behavior, or powering a trading bot, you need accurate, real-time wallet data.

But here's the problem: most APIs only show you tokens sitting in a wallet. The moment a user deposits into a lending protocol, adds liquidity to a pool, or stakes their tokens—those assets "disappear" from traditional balance queries.

Vybe solves this with complete wallet intelligence that tracks assets across 50+ DeFi protocols, giving you the true picture of any wallet's holdings.

Value Proposition: DeFi positions no one else has.

What Makes Vybe Different

Feature	Traditional APIs	Vybe
Token Balances	✅	✅
NFT Holdings	✅	✅
USD Valuations	Sometimes	✅ Always (vetted prices)
DeFi Positions	❌	✅ LP, lending, staking
Historical Data	Rarely	✅ 30-day time series
Labeled Wallets	❌	✅ CEX, KOL, protocols
Multi-wallet Batch	Limited	✅ Up to 10 wallets

What's Available

Vybe's wallet endpoints go beyond basic balance queries:

Data	Description	Endpoint
Token Balances	All SPL tokens with USD values	`/wallets/{addr}/token-balance`
Balance History	Portfolio value over time (30 days)	`/wallets/{addr}/token-balance-ts`
NFT Holdings	NFTs with collection info and floor prices	`/wallets/{addr}/nft-balance`
DeFi Positions	LP, lending, staking positions	`/wallets/{addr}/defi-positions`
Labeled Wallets	Identify CEX, KOL, project wallets	`/wallets/known-accounts`
Batch Queries	Query up to 10 wallets at once	`/wallets/batch/*`

Quick Example

Get a wallet's complete token portfolio with one call:

curl "https://api.vybenetwork.com/wallets/YourWallet/token-balance?sortByDesc=value" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "ownerAddress": "YourWallet",
  "totalTokenValueUsd": "15234.56",
  "totalTokenValueUsd1dChange": "+234.12",
  "data": [
    {
      "symbol": "SOL",
      "amount": "50.5",
      "valueUsd": "9363.71",
      "priceUsd1dChange": "+2.3%"
    }
  ]
}

Unique to Vybe: DeFi Positions

No other Solana API provides this. When tokens are deposited into DeFi protocols, they're invisible to standard balance queries. Vybe tracks them across:

Protocol Type	Examples
Liquidity Pools	Raydium, Meteora, Orca, Lifinity
Lending	Solend, Marginfi, Kamino
Liquid Staking	Marinade, Jito, Sanctum, BlazeStake
Yield Farming	Various yield aggregators

curl "https://api.vybenetwork.com/wallets/YourWallet/defi-positions" \
  -H "X-API-Key: YOUR_API_KEY"

This means your portfolio trackers show true net worth, not just wallet balances.

Common Use Cases

Application	How Wallet Intelligence Helps
Portfolio Tracker	Display complete holdings including DeFi
Trading Bot	Check balances before executing swaps
Whale Watcher	Monitor high-value wallets in real-time
Copy Trading	Track what successful traders hold
Fund Dashboard	Aggregate multi-sig or DAO wallets
Tax Reporting	Historical snapshots for compliance
Airdrop Checker	Verify token/NFT ownership

In This Section

Token Balances - Current SPL token holdings with USD values
Balance History - Track portfolio value over time
NFT Balances - NFT portfolio with floor prices
DeFi Positions - LP, lending, and staking positions
Labeled Wallets - Database of known entities
Batch Queries - Query multiple wallets at once