用途:让 AI 智能体以按请求付费方式访问 GoldRush 区块链数据,无需 API Key、注册或账单,只需一个已充值钱包。通过透明反向代理提供 Foundational API 端点。
主要能力:x402 流程为请求端点、收到 402 支付指令、用 Base 上的稳定币签名支付并重试、服务器验证后返回数据。客户端库自动处理支付步骤,代码中表现为普通 GET 请求。代理在收费前验证请求,地址格式错误、链不支持或参数错误会返回明确错误且不收费。x402 与 Foundational API 端点、参数和响应格式相同,基础 URL 映射为 https://api.covalenthq.com/v1/... 对应 https://x402.goldrush.dev/v1/...。
使用方式:安装 npm install @x402/core @x402/evm,使用 HTTPClient 与 ExactEvmScheme 配置网络和私钥后发起请求。发现端点免费,可用 curl https://x402.goldrush.dev/v1/x402/endpoints 与 search 查询,再评估具体端点获取费率、定价模型和支持链。可变长度数据按 tier 查询参数选择 small、medium、large、xl。缓存响应更便宜,余额缓存 30 秒,价格数据 5 分钟。
适用场景:构建需要链上数据的自主智能体、快速查询代币余额与 NFT 持有、交易与事件日志分析等。
限制:支付目前为 Base Sepolia 测试网 USDC,Base 主网支持即将推出。定价分固定与分层两种模型,具体费率需通过发现 API 查询。详细端点参数与响应模式参见 goldrush-foundational-api 技能。其他未提供信息暂未说明。