x402

Set an x402 low-balance rule. (admin access required)

Creates or updates a low-balance rule for a managed EVM wallet on a chain and asset ("native" for gas, otherwise an ERC-20 contract).

post/x402/low-balance

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/low-balance
  • Auth: API key in header token

Request body

evmWalletIdstring required
caip2Networkstring required
thresholdAmountstring required

Alert threshold in base units

enabledboolean

Example request

{
  "evmWalletId": "clmanagedwallet0002",
  "caip2Network": "eip155:8453",
  "asset": "native",
  "thresholdAmount": "10000000000000000"
}

Response

Low-balance rule saved

status'success' required

Example response

{
  "status": "success",
  "data": {
    "id": "clx402lbrule0001",
    "evmWalletId": "clmanagedwallet0002",
    "evmWalletAddress": "0x5555555555555555555555555555555555555555",
    "caip2Network": "eip155:8453",
    "asset": "native",
    "thresholdAmount": "10000000000000000",
    "enabled": true,
    "status": "Healthy",
    "lastKnownAmount": "50000000000000000",
    "lastCheckedAt": "2026-06-02T12:00:00.000Z",
    "lastAlertedAt": null,
    "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.