Agent Wallets

Aggregated agent wallet transactions

Canonical USDC transfers across an application's agent wallets, newest first. Any other asset, native coin included, is left out: an airdropped lookalike token never shows up in the history. A payment Keyban covered from its welcome offer leaves the Keyban sponsor wallet and is listed with sponsored: true. The welcome offer itself is listed once at its grant date as a sponsor-grant row, with no amount and left out of the totals, on the offer network and only when neither direction nor destination narrows the list.

get/v1/agent-wallets/expenses/transactions

Request

  • Base URL: https://api.prod.keyban.io
  • URL: https://api.prod.keyban.io/v1/agent-wallets/expenses/transactions
  • Auth: one of:
    • API key in header X-Api-Key
    • bearer (a scheme the document does not define)

Query parameters

applicationIdstring uuid required
agentIdstring uuid
ownerIdstring uuid
destinationstring
Example:api.shop.example.com

Filter to outgoing payments whose x402 destination host matches this value (the seller host, e.g. "api.shop.example.com"). Resolved to the set of on-chain recipient addresses of matching consumed intents. Omit for all destinations.

direction'out' | 'in'
Example:out

Restrict to outgoing payments ("out") or incoming funds ("in"). Omit for both.

currentPageinteger
pageSizeinteger

Response

totalinteger required

Total count of items matching the query

Example response

{
  "data": [
    {
      "kind": "transfer",
      "id": "0xabc123…#0",
      "date": "2026-06-01T14:32:00.000Z",
      "txHash": "0x5e1d3a7c8b2f4e9a0c6d1b3f8a2e4c7d9b1f3a5c7e9d0b2f4a6c8e0d2b4f6a8c",
      "direction": "out",
      "counterparty": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "resource": "api.shop.example.com/premium/report",
      "service": {
        "name": "Fiber AI",
        "via": "Orthogonal"
      },
      "amountRef": "1180",
      "intentId": "550e8400-e29b-41d4-a716-446655440000",
      "decidedBy": "jane.doe@example.com",
      "decidedAt": "2026-06-17T14:32:00Z",
      "value": "12500000",
      "decimals": 6,
      "tokenSymbol": "USDC",
      "tokenAddress": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "success": true,
      "agent": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "label": "Procurement bot",
        "network": "BaseSepolia",
        "owner": {
          "id": "aH3kQ9xR2bN7",
          "name": "Jane Doe",
          "email": "jane.doe@example.com"
        }
      }
    }
  ]
}

Changes