Skip to content

Get Token Account

This example shows how to retrieve information about a token account.

Code

#!/usr/bin/env python3
"""
Solana Cookbook - How to Get a Token Account
"""

import asyncio
from solana.rpc.async_api import AsyncClient
from solders.pubkey import Pubkey
from spl.token.instructions import get_associated_token_address
from spl.token.constants import TOKEN_PROGRAM_ID

async def main():
    rpc = AsyncClient("https://api.devnet.solana.com")

    # Example mint and authority addresses
    mint_address = Pubkey.from_string("4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU")
    authority = Pubkey.from_string("AC5RDfQFmDS1deWZos921JfqscXdByf8BKHs5ACWjtW2")

    # Find associated token address
    associated_token_address = get_associated_token_address(
        owner=authority,
        mint=mint_address,
        token_program_id=TOKEN_PROGRAM_ID
    )

    async with rpc:
        try:
            # Get token account info
            account_info = await rpc.get_account_info(associated_token_address)

            print(f"Associated Token Address: {associated_token_address}")
            if account_info.value:
                print(f"Owner: {account_info.value.owner}")
                print(f"Lamports: {account_info.value.lamports}")
                print(f"Data Length: {len(account_info.value.data)} bytes")
                print(f"Executable: {account_info.value.executable}")
            else:
                print("Token account not found")

        except Exception as e:
            print(f"Error getting token account info: {e}")

if __name__ == "__main__":
    asyncio.run(main())

Explanation

  1. Calculate ATA address: Use get_associated_token_address() to find the token account address
  2. Get account info: Retrieve the account information from the blockchain
  3. Display information: Show the account details if it exists

Key Concepts

  • Associated Token Account: A deterministic account address for holding tokens
  • Account info: Contains owner, lamports, data, and executable flag
  • Token account existence: Accounts must be created before they can hold tokens

Usage

python get_token_account.py

This will output: 

Associated Token Address: 7Nm...xyz
Owner: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
Lamports: 2039280
Data Length: 165 bytes
Executable: False

Error Handling

If the token account doesn't exist, you'll see: 

Associated Token Address: 7Nm...xyz
Token account not found