快速开始 · 给开发者

HTTP API

不需要 SDK。市场里的每个 API 都能用普通 HTTP 请求加上你的 Pikeway key 调用,任何语言、任何工具都行。

1

获取 key

登录、充值余额,然后在控制台 → API Keys 创建 key。key 以 pk- 开头,可以调用所有 API。

bash

export PIKEWAY_API_KEY=pk-...

key 只放在服务端。浏览器应用请改用受限的浏览器 key。浏览器 key

2

调用 API

从市场页面拿到 API 的 slug,后面接上服务商原本的路径和查询参数。Pikeway 会转发请求方法、查询参数、请求头和请求体,并原样返回服务商的响应。

ANYhttps://gw.pikeway.ai/gw/<slug>/<path>

bash

curl -i "https://gw.pikeway.ai/gw/dexscreener/latest/dex/search?q=WBTC" \
  -H "Authorization: Bearer $PIKEWAY_API_KEY"

3

查看费用

网关返回的每个响应都带有说明本次调用情况的响应头:

X-Pikeway-Coststring

本次调用的费用(美元),例如 0.002。调用失败(HTTP 400 及以上)时为 0,因为失败不收费。

X-Pikeway-Call-Idstring

本次调用的唯一 ID。可以在用量日志里查到,联系支持时也请附上。

X-Pikeway-CacheHIT | MISS

可缓存的 GET 端点才有。HIT 表示命中缓存。

错误码

4

用 Mock 免费测试

把 /gw/ 换成 /mock/,即可拿到端点的示例响应,不会请求服务商。不需要 key、不收费,每个 IP 每分钟最多 30 次。

bash

curl "https://gw.pikeway.ai/mock/dexscreener/latest/dex/search?q=WBTC"

了解 Mock

让网关帮你挑端点

不知道该调哪个 API 时,可以用 agent 接口通过 HTTP 走 discover → inspect → run 流程。discover 和 inspect 免费,不需要 key。

bash

curl -X POST https://gw.pikeway.ai/v1/discover -H "Content-Type: application/json" \
  -d '{"query":"token price on solana","limit":3}'

curl -X POST https://gw.pikeway.ai/v1/inspect -H "Content-Type: application/json" \
  -d '{"provider":"birdeye","endpoint":"/defi/price"}'

curl -X POST https://gw.pikeway.ai/v1/run -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PIKEWAY_API_KEY" \
  -d '{"provider":"birdeye","endpoint":"/defi/price","input":{"address":"So11111111111111111111111111111111111111112"}}'

下一步

API 参考

网关、AI 与 agent 接口的完整说明。

SDK

带重试、每次调用都返回费用的类型化客户端。