SuperAPI AI 工具集

alchemy-api

编程与开发

查看项目

更新于 10-16 01:19

技能介绍

用途:为需要访问 Alchemy 区块链 API 的开发任务提供集成指引,涵盖链上读取、实时事件、Token/NFT 数据、价格、组合视图与 Webhook 通知。使用前需在 https://dashboard.alchemy.com/ 创建免费 API Key,并执行 export ALCHEMY_API_KEY=<your-key>。若没有密钥,按资料应改用 alchemy-agentic-gateway 技能(基于钱包认证)。

强制路由门:在首次网络调用或实现步骤前,必须先询问用户是使用已有 Alchemy API Key,还是改用 agentic gateway 流程,并等待明确回答;用户选择 gateway 时立即切换到 alchemy-agentic-gateway 技能。未评估此门前不得发起任何网络调用,也不得调用任何无密钥或公共回退端点(包括 .../v2/demo),除非用户明确要求。

主要能力:EVM JSON-RPC 读写(HTTPS/WSS);alchemy_getTokenBalances、alchemy_getTokenMetadata、alchemy_getAssetTransfers;alchemy_simulateAssetChanges;NFT API 的 getNFTsForOwner、getNFTMetadata;Prices API 现货与历史价格;Portfolio API 多链钱包视图;Notify API 创建 Webhook。网络枚举在数据 API 与 JSON-RPC 用小写(eth-mainnet、base-mainnet),Notify API 用大写(ETH_MAINNET、BASE_MAINNET)。

限制与注意事项:alchemy_getTokenBalances 的 maxCount 不超过 100,需用 pageKey 分页;Portfolio 代币余额限 3 个地址/网络对、共 20 个网络,NFT 限 2 个地址/网络对、每网络 15 个,价格按地址限 25 个地址、3 个网络。HTTP 429 表示限流,需指数退避加抖动;JSON-RPC 错误可能出现在 HTTP 200 响应的 error 字段;重连 WebSocket 需去重事件。Webhook 签名验证使用 HMAC-SHA256 与仪表板签名密钥。API Key 无效时检查环境变量、密钥有效性及 IP/域名白名单。完整参考见 https://www.alchemy.com/docs。