Typed Alchemy

A fully typed, validated async client for the Alchemy API.

from typed_alchemy import Alchemy

async with Alchemy.new() as client:
  prices = await client.prices.by_symbol(symbols=['ETH', 'BTC'])
  transfers = await client.transfers('ethereum').get_asset_transfers({
    'fromBlock': '0x0',
    'toAddress': '0x5c43B1eD97e52d009611D89b74fA829FE4ac56b1',
    'category': ['external'],
    'maxCount': '0x2',
  })

Why Typed Alchemy?

• 🎯 Precise Types: Typed request and response models across Portfolio, Prices, NFT, Token, Transfers, Utility, and Simulation endpoints.
• ✅ Runtime Validation: Responses validated by default, not just typed on paper.
• ⚡ Async First: One shared async HTTP transport, ready for concurrent requests.
• 📚 Full Surface: Every supported network exposed uniformly, not just Ethereum.

Installation

pip install typed-alchemy

How To

• Look Up Token Prices
• Inspect Wallet Portfolio
• Query NFTs
• Get Asset Transfers
• Paginate Through Results
• Advanced RPC Methods
• Streaming Support Status

Reference

• API Keys Setup
• Async Usage
• Error Handling
• Environment Variables
• Timestamps

Design Philosophy

Typed Alchemy follows the principles outlined in this blog post.

Details matter. Developer experience matters.