工作原理
Pikeway 位于你的 agent 和数百个第三方 API 之间。agent 找到合适的端点、看清参数和价格、发起调用,只有调用成功才付钱。
三步:discover、inspect、run
无论用哪种方式接入(MCP、CLI、SDK、HTTP),流程都一样。agent 不需要知道任何服务商的地址,也不需要单独注册他们的套餐。
Discover:找端点
用一句话描述需求,比如“solana 上的代币价格”。Pikeway 返回匹配的端点,按相关度、可靠性和价格排序。免费,不需要 key。
Inspect:看参数和价格
花钱之前,先查看端点的参数结构、示例输入和确切的单次价格。同样免费。
Run:调用
按结构化参数调用端点。Pikeway 把请求转发给服务商,原样返回响应,并记下这次调用的费用。
在终端里走一遍
pikeway discover -q "token price on solana" # free
pikeway inspect -p birdeye -e /defi/price # free: schema + price
pikeway run -p birdeye -e /defi/price -i '{"address":"So11111111111111111111111111111111111111112"}'一把 key,一个余额
你只需要充值一个余额,并在 控制台 → API Keys 创建 API key。key 形如 pk-…,可以调用市场里的所有 API。调用时放在请求头 Authorization: Bearer pk-… 里即可。
- 每个端点都有固定的单次价格,在市场页面可见,discover 和 inspect 也会返回。
- 每个响应都带有
X-Pikeway-Cost(本次费用,单位美元)和X-Pikeway-Call-Id(可在用量日志里查到这次调用)。 - 给每个 agent 或项目单独建 key,方便分别统计和吊销。
只为成功的调用付费
服务商返回 2xx 状态码时,按标价计费。其他情况(参数错误、服务商报错、超时)一律不收费,响应里也会标明 X-Pikeway-Cost: 0。
正因如此,让 agent 自己摸索也很放心:参数猜错了不会花你一分钱。
用 Mock 免费测试
把路径里的 /gw/ 换成 /mock/,网关就会返回该端点的示例响应,而不去请求服务商。不需要 key、不收费,按 IP 限流。适合在写解析逻辑时使用。
bash
curl https://gw.pikeway.ai/mock/dexscreener/latest/dex/search?q=WBTC