Solana API: Wallet Balances & Transactions

Probably best free Solana API for wallet balances, SPL token holdings, and complete transaction history. DeFi position tracking included.

Probably best free Solana API for wallet balances, SPL token holdings, and complete transaction history. DeFi position tracking included.

If you’re building anything on Solana that needs wallet data, whether that’s a portfolio tracker, a DeFi dashboard, a tax tool, or an AI assistant, the CoinStats Solana API is a good fit for most use cases. One endpoint returns native SOL balances, all SPL token holdings, and full transaction history for any Solana address. DeFi positions across protocols like Raydium, Orca, Jupiter, and Marinade are detected automatically, so you don’t need to integrate each protocol separately.

The alternative is running your own Solana RPC node, parsing raw transaction data, maintaining a token registry, and building indexing infrastructure for DeFi protocols. CoinStats handles all of that. You get clean, structured JSON with current prices, USD valuations, and 24h changes included in every response.

The same Solana wallet data is also available through CoinStats MCP Server, so AI agents and LLM-powered tools can query Solana wallets directly without custom API calls.

What You Get

Complete SPL Token Support

All SPL tokens in a wallet returned in a single call with current prices, market data, and 24h changes.

Native SOL Balance

SOL balance with real-time USD valuation, BTC price, and volume data.

Full Transaction History

Every transaction with detailed metadata: amounts, timestamps, token identifiers, and USD values.

DeFi Position Detection

Staking, lending, and LP positions across Solana DeFi protocols detected per wallet automatically.

Multi-Wallet Queries

Query multiple Solana wallets in a single request for aggregated portfolio views.

Real-Time Pricing

Current market prices, 24h change percentages, and volume for every token in the response.

Why This Matters for Solana Developers

Solana’s architecture makes wallet data harder to work with than most chains. Transactions are packed into blocks at high throughput, token accounts are separate from the main wallet account, and DeFi interactions span dozens of programs with different data formats. Building a reliable wallet data pipeline from scratch means running an RPC node (or paying for a premium one), parsing instruction data for each DeFi protocol, and maintaining a token metadata registry.

CoinStats API abstracts all of this. You send a wallet address, and the response comes back with every token, every balance, current prices, and DeFi positions already resolved. The data is the same infrastructure that powers the CoinStats app used by over 1M people every month.

Get Wallet Balance

Retrieve all tokens and SOL balance for a Solana wallet:

cURL

curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/balance?address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU&connectionId=solana"

40 credits per request

Example Response

[
  {
    "coinId": "solana",
    "amount": 2.5,
    "name": "Solana",
    "symbol": "SOL",
    "price": 185.42,
    "priceBtc": 0.00191,
    "imgUrl": "https://static.coinstats.app/coins/1614160068120.png",
    "pCh24h": 5.2,
    "rank": 6,
    "volume": 2450000000,
    "chain": "solana"
  },
  {
    "coinId": "serum",
    "amount": 150.0,
    "name": "Serum",
    "symbol": "SRM",
    "price": 0.42,
    "priceBtc": 0.0000043,
    "imgUrl": "https://static.coinstats.app/coins/1598880399409.png",
    "pCh24h": -2.1,
    "rank": 234,
    "volume": 15000000,
    "chain": "solana"
  }
]

The response includes every token in the wallet with its current price, amount held, 24h price change, market cap rank, and trading volume. This is enough data to render a complete portfolio view without making additional API calls for pricing. Each token also includes an image URL, so you can render token icons directly from the response.

Get Transaction History

Retrieve complete transaction history for a Solana wallet:

cURL

curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/transactions?address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU&connectionId=solana&limit=10"

30 credits per request. Make sure to sync transactions first using PATCH /wallet/transactions.

Transaction data includes token transfers, DeFi protocol interactions (swaps, LP deposits/withdrawals, staking), program invocations, and native SOL transfers. Each record has a timestamp and the token amounts involved, which is what tax tools need for cost-basis calculations.

Sync Transactions

Before retrieving transaction data, sync the wallet to ensure up-to-date information:

cURL

curl -X PATCH \
  -H "X-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  "https://openapiv1.coinstats.app/wallet/transactions?address=7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU&connectionId=solana"

50 credits per sync request

The sync step is important because Solana transaction data is indexed asynchronously. Calling sync before querying ensures you get the latest transactions, including recent DeFi interactions, token swaps, and staking activity. For applications that need near-real-time data, sync the wallet on each user session or at regular intervals.

Multiple Wallets

Query multiple Solana wallets in a single request:

curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/transactions?wallets=solana:7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU,solana:8yKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAtZ"

This is useful for portfolio trackers where a user has multiple Solana wallets, or for applications that need to aggregate balances across several addresses into a single view. Many Solana users maintain separate wallets for DeFi, long-term holdings, and active trading, so multi-wallet support covers a common real-world pattern.

Credit Costs at a Glance

Endpoint	Credits	Description
Wallet balance	40	All tokens + SOL balance for one address
Transaction history	30	Paginated transaction list
Transaction sync	50	Index latest transactions before querying
Multi-wallet query	30 per wallet	Transactions for multiple addresses

Credit-based pricing means you pay based on what you actually call. Basic market data calls cost 1-2 credits, while wallet operations cost more because they involve on-chain data indexing. The free tier includes enough credits to build and test your integration before scaling.

What You Can Build With Solana Wallet Data

DeFi Portfolio Tracking

Solana’s DeFi ecosystem spans Raydium, Orca, Jupiter, Marinade, Drift, Mango, and dozens of other protocols. Each protocol has its own program structure and account layout, making it difficult to aggregate DeFi exposure from raw on-chain data. The CoinStats Solana API detects DeFi positions automatically per wallet address, so you don’t need to integrate each protocol separately.

Build dashboards that show a user’s staking rewards alongside LP positions, yield farming returns, and token balances, all from a single API call. The response normalizes everything into the same format: token, amount, current price, 24h change. This means your frontend code doesn’t need protocol-specific rendering logic.

Token Portfolio Analysis

For portfolio tracking apps, the balance endpoint returns everything you need in one call: token amounts, current USD values, 24h price changes, and market cap rankings. Combined with the transaction history endpoint, you can calculate profit/loss, average buy prices, and holding period returns for each SPL token.

A typical integration flow: call the balance endpoint to get current holdings, call the transaction history endpoint to get the buy/sell history, then calculate PnL by comparing current prices to average cost basis. The API provides USD values for each token, so you don’t need a separate price feed.

Transaction Monitoring and Tax Reporting

The transaction history endpoint returns every transaction a wallet has made, including token transfers, DeFi interactions, staking rewards, and program invocations. Each transaction includes timestamps and token identifiers, giving tax tools the raw data needed for cost-basis calculations without requiring users to connect directly to Solana RPC nodes.

For tax reporting, the key data points are: when a token was acquired, at what price, when it was sold or transferred, and at what price. The CoinStats API provides all of this. The transaction sync step ensures you capture the latest activity, including any DeFi yield that has been claimed or compounded.

Wallet Explorers and Address Lookup Tools

If you’re building a Solana block explorer or address lookup tool, the balance endpoint gives you a complete snapshot of any wallet’s holdings. Unlike raw RPC calls that return account data in binary format, the CoinStats API response includes human-readable token names, symbols, prices, and image URLs. This means you can render a full wallet view directly from the API response.

AI-Powered Solana Assistants

Through CoinStats MCP Server, AI agents can look up any Solana wallet balance, check token holdings, and retrieve transaction history using natural language queries. An AI assistant can answer questions like “What’s in this Solana wallet?” or “How much SOL does this address hold?” by querying the MCP Server directly.

This is useful for building chatbots, copilot features, research tools, or any product where an LLM needs structured Solana data. The MCP Server wraps the same endpoints documented on this page, so the data is identical whether you use the REST API or the MCP interface.

Solana vs. Other Chains

If your application needs wallet data beyond Solana, the CoinStats API uses the same endpoint format and response structure across all supported chains. The same code that queries a Solana wallet can query an Ethereum address, a Bitcoin xpub, or a Cardano wallet by changing the connectionId parameter. See Ethereum & EVM Chains page, Bitcoin Wallet Integration page, or Multi-Chain Support page for chain-specific documentation.

Getting Started

1. Sign up at CoinStats API dashboard and generate an API key
2. Make your first balance request with the cURL example above
3. Explore the full Solana endpoint in API Reference

The free tier includes enough credits to test all Solana endpoints. No credit card required to start.

Common Solana Addresses

For testing and development:

Type	Address	Description
Exchange	7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU	Sample exchange wallet
DeFi User	9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM	Active DeFi participant

Always sync transaction data before querying for the most accurate results.