快速开始 · 给开发者

SDK

轻量的 TypeScript 和 Python 客户端。使用 Pikeway key,或让 agent 无需账户、用 USDC 按次付费。

1

安装

这些包还没发布到 npm 或 PyPI,请直接从本站安装:

bash

npm i https://pikeway.fi/sdk/pikeway-sdk-0.1.0.tgz   # + viem for x402

下载 pikeway-sdk-0.1.0.tgz

2

使用 API key 调用

在控制台 → API Keys 创建 key。call() 接收 API 的 slug、服务商路径和查询参数,返回数据以及本次费用和调用 ID。

typescript

import { Pikeway } from '@pikeway/sdk';

const pw = new Pikeway({ gateway: 'https://gw.pikeway.ai', apiKey: process.env.PIKEWAY_API_KEY });
const { data, cost, callId } = await pw.call('dexscreener', '/latest/dex/search', { q: 'WBTC' });

3

让 agent 自己挑端点

和 agent 通过 MCP 使用的 discover → inspect → run 流程一样,只是在代码里调用。discover 和 inspect 免费,不需要 key。

typescript

// find → check inputs and price → run (discover / inspect need no key)
const [best] = await pw.discover('token price on solana');
const spec = await pw.inspect(best.provider, best.endpoint);
const run = await pw.run(best.provider, best.endpoint, spec.exampleInput);   // run.status, run.output, run.cost
const job = await pw.runAndWait(best.provider, best.endpoint, spec.exampleInput); // async + poll
const reply = await pw.chat({ model: 'gpt-4o-mini', messages: [{ role: 'user', content: 'gm' }] });

SDK 提供什么

一个客户端,调用所有 API

call(slug, path, query):市场里每个 API 都用同一个方法。

绝不重复扣费

429/5xx 响应会退避重试,但带付款的请求绝不会自动重试。

类型化错误

PikewayError.code 取值为 auth、payment_required、insufficient_balance、rate_limited、not_found 或 upstream 之一。

每次调用都返回费用

每个结果都包含 cost、callId、是否命中缓存以及链上付款凭证。

零依赖的 Python

只用标准库。eth-account 可选,仅 x402 需要。