CLI 参考

pikeway runs list

列出最近的运行记录,按时间倒序,附状态和费用。

用法

bash

pikeway runs list [--limit 20] [--cursor <cursor>] [-p <provider>] [--async] [--json]
pikeway runs                      # same as runs list

说明

读取 key 所属账户的 GET /v1/runs。默认列出同步调用;加 --async 改为列出后台运行,包括仍在排队或运行中的。还有更多结果时,最后一行会给出翻到下一页的完整命令。

不带子命令的 runs 等同于 list。需要 key。

参数

--limit, -linteger

每页条数。默认 20,最大 100。

--cursorstring

上一页返回的游标(more: 后面打印的值,或 JSON 中的 cursor)。

--provider, -pstring

只看该 API slug 的运行。

--asyncboolean

列出后台运行(用 --async / --wait 启动的),而不是同步调用。

示例

bash

# last 20 calls
pikeway runs list

# only Birdeye, 50 per page
pikeway runs list -p birdeye --limit 50

# next page
pikeway runs list --cursor MjAyNi0xMC0yNFQwOToxMDo0Ny4...

# background runs, including queued / running ones
pikeway runs list --async

# total spent on the last 100 calls
pikeway runs list -l 100 --json | jq '[.items[].cost.value] | add'

输出

text

2026-10-24T09:12:03Z  ✓ 0192f6b0-5e2a-7d40-b1c3-8f9e2a4d6c11  birdeye GET /defi/price  $0.001
2026-10-24T09:10:47Z  ✗ 0192f6af-11c4-7a0e-9b52-3d7e8f1a2c64  coingecko GET /simple/price  $0

more: pikeway runs list --cursor MjAyNi0xMC0yNFQwOToxMDo0Ny4…

✓ 已完成,… 排队中或运行中,✗ 其他(失败、已停止、超时)。
使用 --async 时,每行末尾会附上小写的状态,如 running 或 completed。
没有记录时输出 No runs yet.

--async

2026-10-24T09:20:00Z  … run_5f0c2b7e9a4d4e1b8c3a6f2d1e0b9a87  someapi POST /reports  $0 running
2026-10-24T08:02:11Z  ✓ run_1a2b3c4d5e6f47a8b9c0d1e2f3a4b5c6  birdeye GET /defi/price  $0.001 completed

--json

json

{
  "items": [
    {
      "runId": "0192f6b0-5e2a-7d40-b1c3-8f9e2a4d6c11",
      "provider": "birdeye",
      "method": "GET",
      "path": "/defi/price",
      "status": "COMPLETED",
      "providerResponse": { "httpStatus": 200 },
      "cost": { "value": 0.001, "currency": "USD" },
      "durationMs": 214,
      "createdAt": "2026-10-24T09:12:03Z"
    }
  ],
  "cursor": "MjAyNi0xMC0yNFQwOToxMDo0Ny4…"
}

最后一页的 cursor 为 null。字段说明见 /v1/runs。

错误与退出码

退出码	错误信息	触发条件
3	no API key: run `pikeway keys add --label main --key pk-...`, set PIKEWAY_API_KEY, or pass --key	没有 --key、没有 PIKEWAY_API_KEY,也没有已保存的当前 key。在发出请求之前就会检查。
3	invalid or revoked API key — add a key with `pikeway keys add --label main --key pk-...` (or use --x402)	网关返回 401(key 不存在、已吊销或已过期)。403 同样以 3 退出。
2	unknown: pikeway runs foo (use list \| get \| stop)	未知子命令。由于会先检查 key,没有 key 时得到的是退出码 3 的错误。
1	cannot reach <gateway>: ECONNREFUSED	无法连接网关(DNS、网络,或 PIKEWAY_API_BASE_URL 写错)。冒号后的错误码来自 Node。

同样支持全局参数 -j, --json 和 -k, --key。见全局参数与退出码。