{"id":28467969,"url":"https://github.com/apeworx/ape-alchemy","last_synced_at":"2026-02-02T23:37:07.509Z","repository":{"id":37784803,"uuid":"433080991","full_name":"ApeWorX/ape-alchemy","owner":"ApeWorX","description":"Alchemy network provider plugin for the Ape Framework","archived":false,"fork":false,"pushed_at":"2025-06-04T14:57:54.000Z","size":3552,"stargazers_count":21,"open_issues_count":9,"forks_count":14,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-07-01T09:44:31.427Z","etag":null,"topics":["alchemy","alchemy-api","alchemyapi","ape","apeworx","ethereum","python","smart-contracts","web3"],"latest_commit_sha":null,"homepage":"https://www.apeworx.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ApeWorX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-29T14:46:01.000Z","updated_at":"2025-05-31T23:06:05.000Z","dependencies_parsed_at":"2023-12-19T04:47:25.224Z","dependency_job_id":"30eb7b30-8499-4fae-834e-07c82c890cb6","html_url":"https://github.com/ApeWorX/ape-alchemy","commit_stats":{"total_commits":61,"total_committers":10,"mean_commits":6.1,"dds":0.4426229508196722,"last_synced_commit":"555cac4e04f8c5ef8af447a719b22955c5bdc04d"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":"ApeWorX/project-template","purl":"pkg:github/ApeWorX/ape-alchemy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fape-alchemy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fape-alchemy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fape-alchemy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fape-alchemy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ApeWorX","download_url":"https://codeload.github.com/ApeWorX/ape-alchemy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fape-alchemy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265555017,"owners_count":23787316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alchemy","alchemy-api","alchemyapi","ape","apeworx","ethereum","python","smart-contracts","web3"],"created_at":"2025-06-07T08:06:10.043Z","updated_at":"2026-02-02T23:37:07.498Z","avatar_url":"https://github.com/ApeWorX.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Start\n\nUse the [Alchemy](https://alchemy.com/?r=jk3NDM0MTIwODIzM) provider plugin to interact with blockchains via APIs.\nThe `ape-alchemy` plugin supports the following ecosystems:\n\n- Abstract\n- ApeChain\n- Arbitrum\n- Astar\n- Avalanche\n- Base\n- Berachain\n- Blast\n- BSC (including opBNB)\n- CrossFi\n- Ethereum\n- Fantom\n- Flow EVM\n- Gnosis\n- Lens\n- Linea\n- Lumia\n- Mantle\n- Metis\n- Optimism\n- Polygon\n- Polygon-ZkEVM\n- Rootstock\n- Scroll\n- Shape\n- Soneium\n- Sonic\n- Unichain\n- XMTP\n- World-Chain\n- zetachain\n- ZkSync\n- Zora\n\n## Dependencies\n\n- [python3](https://www.python.org/downloads) version 3.9 up to 3.12.\n\n## Installation\n\n### via `pip`\n\nYou can install the latest release via [`pip`](https://pypi.org/project/pip/):\n\n```bash\npip install ape-alchemy\n```\n\n### via `setuptools`\n\nYou can clone the repository and use [`setuptools`](https://github.com/pypa/setuptools) for the most up-to-date version:\n\n```bash\ngit clone https://github.com/ApeWorX/ape-alchemy.git\ncd ape-alchemy\npython3 setup.py install\n```\n\n## Quick Usage\n\nFirst, make sure you have one of the following environment variables set (it doesn't matter which one):\n\n- `WEB3_ALCHEMY_PROJECT_ID`\n- `WEB3_ALCHEMY_API_KEY`\n- `WEB3_\u003cecosystem\u003e_\u003cnetwork\u003e_ALCHEMY_PROJECT_ID`\n- `WEB3_\u003cecosystem\u003e_\u003cnetwork\u003e_ALCHEMY_PROJECT_ID`\n\nFor example, to use both Arbitrum and Ethereum in the same session, you could set both `WEB3_ARBITRUM_MAINNET_ALCHEMY_PROJECT_ID` and `WEB3_ETHEREUM_MAINNET_ALCHEMY_PROJECT_ID`.\n\n**NOTE**: If using non-Ethereum networks, take care to install the correct plugins, such as `ape-arbitrum`, `ape-optimism`, etc:\n\n```bash\nape plugins install arbitrum\n```\n\nThen, either in your current terminal session or in your root RC file (e.g. `.bashrc`), add the following:\n\n```bash\nexport WEB3_ALCHEMY_PROJECT_ID=MY_API_TOKEN=\u003cvalue-of-secret-key\u003e\n```\n\nTo use the Alchemy provider plugin in most commands, set it via the `--network` option:\n\n```bash\nape console --network ethereum:sepolia:alchemy\n```\n\nTo connect to Alchemy from a Python script, use the `networks` top-level manager:\n\n```python\nfrom ape import networks\n\nwith networks.parse_network_choice(\"ethereum:mainnet:alchemy\") as provider:\n    ...\n```\n\n### Transaction Traces\n\nIf you are using a paid tier of Alchemy, you have access to both Geth and Parity style traces.\nParity traces are faster and thus are the ones uses in Ethereum receipts' `show_trace()` method:\n\n```python\nfrom ape import networks\n\nalchemy = networks.provider  # Assuming connected to Alchemy\ntxn_hash = \"0x053cba5c12172654d894f66d5670bab6215517a94189a9ffc09bc40a589ec04d\"\nreceipt = alchemy.get_transaction(txn_hash)\nreceipt.show_trace()  # Prints the Transaction trace\n```\n\nTo access the raw `CallTree`, do:\n\n```python\nfrom ape import networks\n\nalchemy = networks.provider  # Assuming connected to Alchemy\ntxn_hash = \"0x053cba5c12172654d894f66d5670bab6215517a94189a9ffc09bc40a589ec04d\"\ncall_tree = alchemy.get_call_tree(txn_hash)\n```\n\nTo learn more about transaction traces, view [Ape's transaction guide](https://docs.apeworx.io/ape/stable/userguides/transactions.html#traces).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapeworx%2Fape-alchemy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapeworx%2Fape-alchemy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapeworx%2Fape-alchemy/lists"}