Async Usage

Alchemy clients are async-first and support two usage styles:

• construct a client and call methods directly for quick one-off requests
• use async with when you want explicit lifecycle management

Quick Usage

For short request-response flows, plain construction is fine — the underlying HTTP transport opens lazily on first use.

from typed_alchemy import Alchemy

client = Alchemy.new()
prices = await client.prices.by_symbol(symbols=['ETH', 'BTC'])
print(prices['data'][0]['prices'])

Context Manager Usage

Use async with when you want the client to open up front and close cleanly at the end of the block. This is the recommended style for multiple requests, long-lived sessions, or code where explicit cleanup matters.

from typed_alchemy import Alchemy

async with Alchemy.new() as client:
  prices = await client.prices.by_symbol(symbols=['ETH', 'BTC'])
  balances = await client.portfolio.token_balances({
    'addresses': [{'address': '0x5c43B1eD97e52d009611D89b74fA829FE4ac56b1', 'networks': ['eth-mainnet']}],
  })

client.portfolio and client.prices are global groups; client.nft(network), client.token(network), client.transfers(network), client.utility(network), and client.simulation(network) are network-scoped groups. Every one of them shares the single HTTP transport opened by the top-level async with Alchemy.new(...) block — there is nothing else to enter separately, whichever combination of groups and networks you call.

Guidance

Use direct construction for quick reads. Use async with by default when doing more than one call or wanting predictable cleanup.