Skip to main content

​
Ethereum & EVM Chain Balances

CoinStats API provides comprehensive support for Ethereum and all EVM-compatible chains, enabling you to track wallets across the entire Ethereum ecosystem with a single integration.

​
Supported EVM Chains

Ethereum

ethereum - The original smart contract platform

Polygon

polygon - Layer 2 scaling solution

BSC

binance - Binance Smart Chain

Arbitrum

arbitrum - Optimistic rollup L2

Optimism

optimism - Optimistic Ethereum L2

Avalanche

avalanche - High-throughput blockchain

​
Key Features

  • Multi-Chain Queries: Get balances across all EVM chains with one request
  • ERC-20 Token Support: Automatic detection of all token standards
  • NFT Holdings: Complete NFT portfolio tracking
  • DeFi Integration: Track liquidity pools, staking, and yield farming
  • Gas Optimization: Batch requests to minimize costs
  • Real-time Updates: Live price feeds and transaction monitoring

​
Single Chain Balance

Get wallet balance for a specific EVM chain: 
curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/balance?address=0x8ba1f109551bD432803012645Hac136c5d3c139&connectionId=ethereum"
40 credits per chain per request
Get wallet balances across all EVM chains simultaneously: 
curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/balances?address=0x8ba1f109551bD432803012645Hac136c5d3c139&networks=all"
400 credits for all chains, or 40 credits × number of specified chains

​
Example Multi-Chain Response

[
  {
    "blockchain": "ethereum",
    "balances": [
      {
        "coinId": "ethereum",
        "amount": 5.2,
        "name": "Ethereum",
        "symbol": "ETH",
        "price": 2450.30,
        "priceBtc": 0.0253,
        "imgUrl": "https://static.coinstats.app/coins/1461576800.png",
        "pCh24h": 3.2,
        "rank": 2,
        "volume": 12000000000,
        "chain": "ethereum",
        "contractAddress": null
      },
      {
        "coinId": "usd-coin",
        "amount": 1000.0,
        "name": "USD Coin",
        "symbol": "USDC",
        "price": 1.0,
        "priceBtc": 0.0000103,
        "imgUrl": "https://static.coinstats.app/coins/1547105068721.png",
        "pCh24h": 0.1,
        "rank": 5,
        "volume": 3000000000,
        "chain": "ethereum",
        "contractAddress": "0xA0b86a33E6411644649C9d1E1d8B9E1C4E4D1C3E"
      }
    ]
  },
  {
    "blockchain": "polygon",
    "balances": [
      {
        "coinId": "matic-network",
        "amount": 500.0,
        "name": "Polygon",
        "symbol": "MATIC",
        "price": 0.85,
        "priceBtc": 0.0000088,
        "imgUrl": "https://static.coinstats.app/coins/1588584860670.png",
        "pCh24h": 2.5,
        "rank": 15,
        "volume": 500000000,
        "chain": "polygon"
      }
    ]
  }
]

​
Transaction History

Get comprehensive transaction history across EVM chains: 
curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/transactions?address=0x8ba1f109551bD432803012645Hac136c5d3c139&connectionId=ethereum&limit=20"
40 credits per chain or 400 credits for all chains

​
Portfolio Chart Data

Track wallet value over time across multiple EVM chains: 
curl -H "X-API-KEY: your-api-key" \
  "https://openapiv1.coinstats.app/wallet/chart?address=0x8ba1f109551bD432803012645Hac136c5d3c139&connectionId=ethereum,polygon&type=1m"

​
Advanced Features

​
Gas Fee Tracking

Monitor gas fees across different EVM chains: 
// Transaction with gas fee analysis
const txWithGas = await fetch('https://openapiv1.coinstats.app/wallet/transactions?address=0x8ba1f109551bD432803012645Hac136c5d3c139&connectionId=ethereum&types=fee', {
  headers: { 'X-API-KEY': 'your-api-key' }
});

​
DeFi Position Tracking

Track complex DeFi positions across protocols: 
// Get all DeFi-related transactions
const defiTx = await fetch('https://openapiv1.coinstats.app/wallet/transactions?address=0x8ba1f109551bD432803012645Hac136c5d3c139&connectionId=ethereum&types=executed,approve', {
  headers: { 'X-API-KEY': 'your-api-key' }
});

​
Connection IDs Reference

ChainConnection IDNative Token
EthereumethereumETH
PolygonpolygonMATIC
Binance Smart ChainbinanceBNB
ArbitrumarbitrumETH
OptimismoptimismETH
AvalancheavalancheAVAX
FantomfantomFTM
BasebaseETH
Use all as connectionId to query all supported EVM chains at once for maximum efficiency.

​
Use Cases

Cross-Chain Portfolio

Track assets across all EVM chains in a unified dashboard

DeFi Yield Farming

Monitor yield farming positions across multiple protocols and chains

Bridge Monitoring

Track assets as they move between different EVM chains

Gas Optimization

Analyze gas costs across chains to optimize transaction timing

​
Common EVM Addresses

For testing and development:
TypeAddressDescription
Whale Wallet0x8ba1f109551bD432803012645Hac136c5d3c139Large ETH holder
DeFi Power User0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503Active across protocols
NFT Collector0x50EC05ADe8280758E2077fcBC08D878D4aef79C3Large NFT collection
Always sync wallet transactions using PATCH /wallet/transactions before querying for the most up-to-date data.