x402

List managed x402 EVM wallets. (read access required; no key material)

Lists managed EVM wallets used to fund x402 payments and settle inbound payments. Results are limited by the key's permitted networks; a key with wallet scoping enabled additionally sees only its assigned and self-created wallets (an unscoped key sees all, the Cardano-parity default). createdById is only returned to admins and for the caller's own wallets.

get/x402/wallets

Request

Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
URL: ./../api/v1/x402/wallets
Auth: API key in header token

Query parameters

takenumber

Number of managed wallets to return

cursorIdstring

Pagination cursor (provide the id of the last returned wallet)

type'Purchasing' | 'Selling'

Filter wallets by direction (Purchasing or Selling)

networkIdstring

Filter wallets by the bound x402 network id

Response

Managed x402 EVM wallets

status'success' required

Example response

{
  "status": "success",
  "data": {
    "Wallets": [
      {
        "id": "clmanagedwallet0001",
        "networkId": "clx402network0001",
        "caip2Network": "eip155:8453",
        "address": "0x1111111111111111111111111111111111111111",
        "type": "Purchasing",
        "note": "Agent payout buyer wallet",
        "createdById": "api_key_id",
        "createdAt": "2026-06-02T12:00:00.000Z",
        "updatedAt": "2026-06-02T12:00:00.000Z"
      },
      {
        "id": "clmanagedwallet0002",
        "networkId": "clx402network0001",
        "caip2Network": "eip155:8453",
        "address": "0x5555555555555555555555555555555555555555",
        "type": "Selling",
        "note": "Base facilitator",
        "createdById": "api_key_id",
        "createdAt": "2026-06-02T12:00:00.000Z",
        "updatedAt": "2026-06-02T12:00:00.000Z"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.