Async Usage

Moralis 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 connections open lazily on first use.

from typed_moralis import Moralis

client = Moralis.new()
balances = await client.evm.wallet.token_balances(
  '0xd8dA6BF26964aF9D7eed9e03E53415D37aA96045', chain='eth',
)
print(balances['result'])

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. Entering Moralis.new(...) is the only thing the caller does -- there's no separate sub-client to enter.

from typed_moralis import Moralis

async with Moralis.new() as client:
  balances = await client.evm.wallet.token_balances(
    '0xd8dA6BF26964aF9D7eed9e03E53415D37aA96045', chain='eth',
  )
  metadata = await client.evm.token.metadata.token_metadata(
    chain='eth', addresses=['0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'],
  )

Moralis routes its 7 product groups (evm, bitcoin, solana, universal, cortex, auth, streams) to 5 different hosts -- evm/bitcoin/universal share one, since they're all served from Moralis's "deep-index" API. Entering the top-level client takes ownership of all 5 transports up front; each still opens its actual HTTP connection lazily, on that transport's own first request, exactly like Quick Usage above.

Moralis has no client-side streaming surface: streams manages server-side webhook subscriptions over plain REST calls, not a socket you read from in Python, so there's no async for message in ... pattern here.

Every call requires an API key: Moralis.new() raises AuthError immediately, before any request is sent, unless api_key is passed or MORALIS_API_KEY is set. There is no public, credential-free mode.

Guidance

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