用途：alchemy-api 是一份可独立使用的参考与集成指南，用于把 Alchemy 的区块链 API 接入实际应用代码，例如服务器、后端、dApp、worker 或脚本。它面向的是会随应用发布的代码，而不是在当前智能体会话中临时发起在线查询；后者应改用 alchemy-mcp。
主要能力：文档按产品面组织，覆盖 EVM 的 JSON-RPC 读写与 WebSocket 订阅，代币余额（alchemy_getTokenBalances）、代币元数据（alchemy_getTokenMetadata）、转账历史（alchemy_getAssetTransfers）、NFT 归属与元数据、代币现价与历史价格、多链钱包组合视图、交易资产变化模拟；同时覆盖 Solana 的 JSON-RPC、DAS 与 Yellowstone gRPC 流式接口，Sui gRPC 的对象、交易、余额与检查点流，以及 Notify API 的 Webhook 创建与签名校验。文档还提供端点选择表、按产品列出的 Base URL 与鉴权表、常用代币地址、分页与调用限额速查，以及速率限制和错误处理建议。
使用方式：先确认属于应用代码集成范围，并检查 $ALCHEMY_API_KEY 是否已设置（例如使用 [ -n "$ALCHEMY_API_KEY" ] 而不打印密钥）。若未设置，可到 https://dashboard.alchemy.com/ 创建免费 API 密钥并写入环境变量。随后根据任务选择端点，按基址与鉴权表配置请求头和 URL，例如 EVM/Base/Arbitrum/BNB/Solana 的 JSON-RPC 均把密钥放在 URL 中，Solana Yellowstone gRPC 使用 X-Token 头，Sui gRPC 使用 Authorization: Bearer，Notify API 使用控制台生成的 X-Alchemy-Token。复制对应的 curl 示例后，先在测试网验证，再接入正式环境。Webhook 接收端应校验签名，Node 示例使用 HMAC-SHA256 与 timingSafeEqual。文档强调不得使用无密钥或公共 RPC 回退端点，除非用户明确要求。
适用场景：需要把链上数据读取、交易查询、NFT 与代币数据、价格、组合资产、交易模拟、实时事件订阅或 Webhook 通知集成到后端服务和脚本中的开发工作。
限制：资料未提供具体收费、价格、各套餐配额，仅提到速率限制与计算单元预算可在控制台查看；分页上限因端点而异，如 alchemy_getTokenBalances 的 maxCount 不超过 100，组合接口对地址/网络组合数量有限制；交易历史接口为 beta，仅限 ETH 与 BASE 主网；数据 API 与 JSON-RPC 用小写网络标识（如 eth-mainnet），Notify API 用大写（如 ETH_MAINNET）；遇到 HTTP 429 需指数退避加抖动，JSON-RPC 错误可能出现在 HTTP 200 响应的 error 字段中。