# Typed Alchemy

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

```python
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

```bash
pip install typed-alchemy
```

## How To

- [Look Up Token Prices](/typed/alchemy/how-to/look-up-token-prices)
- [Inspect Wallet Portfolio](/typed/alchemy/how-to/inspect-wallet-portfolio)
- [Query NFTs](/typed/alchemy/how-to/query-nfts)
- [Get Asset Transfers](/typed/alchemy/how-to/get-asset-transfers)
- [Paginate Through Results](/typed/alchemy/how-to/paginate-through-results)
- [Advanced RPC Methods](/typed/alchemy/how-to/advanced-rpc-methods)
- [Streaming Support Status](/typed/alchemy/how-to/listen-to-streams)

## Reference

- [API Keys Setup](/typed/alchemy/api-keys)
- [Async Usage](/typed/alchemy/reference/async-usage)
- [Error Handling](/typed/alchemy/reference/error-handling)
- [Environment Variables](/typed/alchemy/reference/env-vars)
- [Timestamps](/typed/alchemy/reference/timestamps)

## Design Philosophy

Typed Alchemy follows the principles outlined in [this blog post](https://tribulnation.com/blog/clients).

*Details matter. Developer experience matters.*