CLI Reference

pikeway activities

Your wallet history: top-ups, per-call charges and other balance changes, newest first.

Synopsis

bash

pikeway activities [--limit 20] [--cursor <cursor>] [--json]

Description

Reads GET /v1/wallet/activities for the account behind your key. Each line shows the time, the amount (negative for charges, + for credits), the type and a description. When there are more entries, the last line is the command for the next page. Needs a key.

Options

--limit, -linteger

Entries per page. Default 20, max 100.

--cursorstring

Cursor from the previous page (printed after more:).

Examples

bash

pikeway activities

# more at once
pikeway activities --limit 100

# next page
pikeway activities --cursor MjAyNi0xMC0yM1QxODo0MDoxMS4...

# only top-ups
pikeway activities -l 100 --json | jq '.items[] | select(.type == "TOPUP")'

Output

text

2026-10-24T09:12:03Z  -0.001  CONSUMPTION  call Birdeye
2026-10-23T18:40:11Z  +10  TOPUP  Top-up

more: pikeway activities --cursor MjAyNi0xMC0yM1QxODo0MDoxMS4…

An account with no history prints nothing and exits 0.
Charges for a call carry the runId in JSON, so you can look them up with pikeway runs get.

--json

json

{
  "items": [
    {
      "id": "6a1f0c52-8d3e-4b7a-9f21-0e4c5d6b7a89",
      "type": "CONSUMPTION",
      "amount": { "value": -0.001, "currency": "USD" },
      "balanceAfter": 12.4831,
      "description": "call Birdeye",
      "createdAt": "2026-10-24T09:12:03Z",
      "runId": "0192f6b0-5e2a-7d40-b1c3-8f9e2a4d6c11"
    },
    {
      "id": "3c9b1e7d-2f4a-4c8e-b5d6-7a8f9e0d1c2b",
      "type": "TOPUP",
      "amount": { "value": 10, "currency": "USD" },
      "balanceAfter": 12.4841,
      "description": "Top-up",
      "createdAt": "2026-10-23T18:40:11Z"
    }
  ],
  "cursor": null
}

Errors and exit codes

Exit	Message	When
3	no API key: run `pikeway keys add --label main --key pk-...`, set PIKEWAY_API_KEY, or pass --key	No --key, no PIKEWAY_API_KEY and no saved active key. Checked before any request is sent.
3	invalid or revoked API key — add a key with `pikeway keys add --label main --key pk-...` (or use --x402)	The gateway answered 401 (unknown, revoked or expired key). A 403 also exits with 3.
1	cannot reach <gateway>: ECONNREFUSED	The gateway could not be reached (DNS, network, wrong PIKEWAY_API_BASE_URL). The code after the colon comes from Node.

Also accepts the global flags -j, --json and -k, --key. See Global flags and Exit codes.