Agent Wallet

Read the spend limits

Changed on

Returns the account owner's two limits and where the rolling 24-hour window stands: maxPerPaymentUsdc with the min, max, and default bounds it can be set within, maxPerDayUsdc, what has been spent and is left of the 24 hours, and maxPaymentNowUsdc, the most one payment may cost right now. The limit defaults to $1,000 and ranges from $1 to $50,000. It applies to every payment agentX402Pay makes, Laso routes and external url endpoints alike.

Check an amount against maxPaymentNowUsdc before attempting a payment rather than waiting to be refused. Compare the fee-inclusive total, since fees are added on top of the amount you request. Read-only to an agent: only the account owner can change the limit, from the dashboard. If a payment would exceed it, do not split it into smaller payments. Stop and tell your human.

A Firebase callable. Callables wrap the request in {"data": ...} and the reply in {"result": ...}. Send the id_token from /auth as a Bearer token. Free.

post/getAgentSpendLimit

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/getAgentSpendLimit
  • Auth: API key in header Authorization

Request body

Example request

{
  "data": {
    "userId": "usr_7aff81763cae58c936aa6de67dd5a95e"
  }
}

Response

The current limits, their bounds, and the rolling window, in USDC.

Example response

{
  "result": {
    "maxPerPaymentUsdc": 1000,
    "min": 1,
    "max": 50000,
    "default": 1000,
    "maxPerDayUsdc": 2500,
    "spentLast24hUsdc": 340.5,
    "remainingTodayUsdc": 2159.5,
    "maxPaymentNowUsdc": 1000,
    "nextReleaseAt": 1792512000000,
    "nextReleaseUsdc": 240
  }
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status