Blog

Introducing real-time balances with Turnkey

Resources
·
·

Balances with Turnkey

Real-time token balances, asset metadata, USD values, and webhook-driven transaction updates for every address Turnkey secures.

What is the solution? Balances give developers native balance data and balance webhooks through Turnkey. Teams can fetch token balances with USD values and asset metadata, detect deposits and withdrawals, and track transaction status across supported networks without relying on additional providers.

What does it solve? Wallet applications need more than secure signing to feel complete. Users need to see what they own, when funds arrive, when withdrawals settle, and whether a transaction is pending, confirmed, finalized, or failed. Real-time balances reduce the need to stitch together separate providers for balance data, token metadata, price feeds, webhooks, and transaction state.

How does it solve this? The Balance API returns real-time token balances with USD values and full asset metadata in a single API call. Webhooks notify applications when balance changes are confirmed, when they reach finality, and as transactions move through their lifecycle.

Who is it built for? Teams building embedded wallets, payment products, DeFi and trading apps, company wallets, treasury workflows, and AI agent systems on Turnkey. Any product that needs secure wallets and real-time balance visibility can use Real-Time Balances as part of their wallet infrastructure stack.

Today, Turnkey is launching real-time token balances for every address we secure, giving developers balance data, asset metadata, USD values, and transaction state through the same wallet infrastructure they already use for signing and transaction management.

Building a wallet application has always required more infrastructure than it should. Teams have had to secure keys in one place, fetch balances from another, wire up webhooks somewhere else, and maintain separate dependencies for token metadata, price data, and transaction status.

Turnkey is making that simpler. With Balances, applications can natively show users what they own, detect when deposits arrive, track when withdrawals settle, and reflect whether a transaction is pending, confirmed, finalized, or failed.

Turnkey’s wallet infrastructure now has real-time balances

Now supporting real-time token balances and balance webhooks across Ethereum, Base, Polygon, Arbitrum, and Solana, with more networks coming soon, Turnkey gives developers one platform for wallets, signing, transactions, and balance state.

This gives teams a way to fetch balances, display assets, detect deposits and withdrawals, and track transaction status without building their own indexing layer or relying on a separate balance provider.

One platform. One integration. 

Everything you need to build wallet balances into any product

Balance API

The Balance API returns real-time token balances with USD values and full asset metadata in a single API call.

That means teams can fetch the current state of a wallet and display it directly in their product, without stitching together separate calls for token prices, symbols, decimals, contract addresses, or logos.

Each supported asset includes the data developers need to build a complete wallet experience:

  • Human-readable token balances
  • USD-denominated values
  • Token symbols
  • Token decimals
  • Contract addresses
  • Token logos

For embedded wallet products, this removes one of the most common pieces of wallet infrastructure teams have historically had to build or buy elsewhere. Users can see what’s in their wallet, applications can surface balances accurately, and developers can spend less time maintaining balance infrastructure.

Webhook-driven wallet updates

Balances also includes webhooks, so applications can react to wallet activity without polling.

In addition to Turnkey’s activity webhooks, Turnkey is adding three new webhooks with Balances:

  • Confirmed balance changes
    Fires when a balance change is detected onchain, allowing applications to update the user experience as soon as a deposit or withdrawal is observed.
  • Finalized balance changes
    Fires when the balance change reaches finality, helping teams distinguish between detected activity and activity that has settled with stronger chain guarantees.
  • Transaction status
    Tracks the full transaction lifecycle from submitted through confirmed to settled or failed, giving applications the state they need to update users, back-office systems, and operational workflows.

Together, these webhooks give teams a cleaner way to build reactive wallet experiences. A deposit can appear when it is detected. A withdrawal can move through pending and finalized states. A transaction can be tracked from submission through outcome without constant API polling.

Why real-time balances matter

Every wallet product needs a balance state. Without native balance infrastructure, teams have to secure keys in one place, fetch balances from another, subscribe to webhooks somewhere else, and manage transaction state through a separate pipeline.

That can create product drag. It also creates operational risk. When these components live in separate systems, teams have to reconcile state across multiple providers before they can give users a clear answer.

Balances brings that state into the same infrastructure that already secures wallets and signs transactions. The result is a more complete wallet stack, with fewer dependencies and clearer visibility across the full transaction lifecycle.

Turnkey: Building for complete wallet experiences

Real-time balances make Turnkey more complete across the product surfaces teams already use and are a natural extension of Turnkey’s infrastructure.

Turnkey already secures wallets, enforces signing policies, offers gas sponsorship, supports transaction management, and helps teams build production-grade onchain applications. 

Balance data is the next layer those applications need to function well.

Every layer above the RPC, from key management and signing through transaction broadcasting and now balance state, is built and operated in-house. That matters for reliability. It matters for roadmap speed. It matters for security boundaries. 

For developers, Turnkey offers one platform for wallets, signing, transactions, and balances.

For end users, it makes wallet experiences feel more complete. Assets can be displayed with the right metadata. Deposits can appear when detected. Transactions can move through clear status states. Applications can react without waiting on a manual refresh or background polling loop.

Get started with Turnkey’s real-time balances

Balances is now available for supported assets across Ethereum, Base, Polygon, Arbitrum, and Solana, with more support coming soon.

Use the Balance API to fetch token balances, USD values, and asset metadata in a single call. Subscribe to webhooks to receive confirmed balance changes, finalized balance changes, and transaction status updates without polling.

Read the docs to start building with Balances.

Get started with Turnkey today. 

Related articles

What makes the best wallet infrastructure provider for crypto payments?

What to look for in crypto payment infrastructure and how Turnkey’s Wallet-as-a-Service helps teams build secure, flexible, and scalable payment products.

Resources
May 27, 2026

Smart contract security for real-world financial applications

Why smart contract security matters for financial applications, how common exploits take advantage of code, and why teams need controls before and after deployment.