x402

Create a managed x402 EVM wallet. (admin access required; returns the generated private key once)

Creates a managed EVM wallet on a network permitted for the API key. When no key is supplied, the generated private key is returned once for backup and stored only in encrypted form.

post/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

Request body

networkIdstring required

Id of the x402 network (payment source) to bind this wallet to

type'Purchasing' | 'Selling' required

Purchasing wallets fund outbound payments; Selling wallets settle inbound ones as facilitators

notestring

Optional human-readable label for the wallet

privateKeystring

Optional 0x-prefixed 32-byte hex private key. A new key is generated when omitted.

Example request

{
  "networkId": "clx402network0001",
  "type": "Purchasing"
}

Response

Managed wallet created

status'success' required

Example response

{
  "status": "success",
  "data": {
    "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",
    "privateKey": "0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d"
  }
}

Changes

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