用途:Feeds 通过 HTTP 回答单个钱包的问题——它持有什么,或它收发过什么,一次请求覆盖所支持的链。Goldsky 负责索引、归一化与定价,调用方无需运行管道。同一主机和同一密钥还提供 Polymarket 与区块头数据源,但它们不遵循下述约定。
主要能力:/feeds/wallets/balances 返回该钱包每个代币(含原生资产)的最新余额及 total_value_usd;/feeds/wallets/transfers 按最新在前返回该钱包的转账,direction 相对 address 为 in 或 out。address 必填且只能是一个钱包。chains 省略则查询所有支持的链,需传规范 slug,逗号分隔;matic、arbitrum、mainnet 分别是 polygon、arbitrum_one、ethereum 的别名,匹配不区分大小写,其他拼写返回 400。token_symbol 按符号匹配,可能命中多个合约;需要特定合约时用 token_address(最多 100 个)。include_unknown_price 默认 false,不代表每行都有价格,price_usd 与 value_usd 可能为 null。include_historical 默认 false,设为 true 可返回零余额行。min_value_usd 过滤低值行并丢弃未定价行,同样作用于 total_value_usd。transfers 的 from、to 是闭区间 RFC 3339 时间界;from_block、to_block 要求恰好一个链,否则返回 422 CONFLICTING_FILTERS。transfer_type 为 native、erc20 或两者,NFT 类型返回 400,spl 被接受但返回空 data。page_size 默认 100,上限 1000,超出会被截断而非拒绝;下一页用 page_token,且仅对生成它的过滤条件有效,每页单独计费。
使用方式:密钥由 API 创建,用 goldsky login 的项目令牌认证,令牌存于 ~/.goldsky/auth_token。创建路径为 POST /api/v1/feeds/api-key,重新显示密钥为 GET /api/v1/edge/feeds/api-key,两种组合互不通用,其他组合为 404。调用时用 x-api-key 头传 GOLDSKY_FEEDS_API_KEY。401 表示未登录,403 表示不是项目 Editor,409 表示存在名为 feeds 的 Edge 端点需先删除。数据源本身缺密钥返回 402(x402 付费体),密钥错误返回 401。
限制:CLI 没有 feeds 命令,且不能用 goldsky edge create 创建(该名称被保留)。余额是最新数量而非历史,重建资金流动需用 transfers。转账对象没有 id,勿用 block_number 或 block_timestamp 做主键。price_usd 与 amount_usd 在请求时计算,之后重读同一转账可能出现不同美元值。balances 可能返回 503(部分链原生余额不可用),应重试而非视为空钱包。Solana 地址通过校验但无链支撑,返回 200 空 data。不支持流式写入(暂无 stream 功能)。更多参数与字段以 https://edge.goldsky.com/data/openapi.json 为准。