# Agent Box Top-Up

> Agent Box Top-Up is a paid API for AI agents from api.arcgate.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-10).

Adds funds or credits to an agent's box (a managed resource container) identified by a blockchain address

## Facts

- Endpoint: POST https://api.arcgate.dev/agent/v1/:address/box/topup?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-box-top-up-cc90aea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AGOPAKyrDFc5efrPmFpk5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-box-top-up-cc90aea1 -d '<json body>'
```

Example prompt: Top up the box for my agent at address 0xABC123 on Arcgate — add the standard amount so it has enough balance to keep running.

## When to prefer this

Use this endpoint when you need to replenish the balance of an already-created agent box associated with a specific blockchain address on the Arcgate platform. This is the correct endpoint after the box has been created via the box create endpoint and needs funding to remain operational. Prefer this over any general payment or swap endpoints when the specific goal is maintaining an agent box's operational balance.

## Known failure modes

- Invalid or unrecognized agent address returns a 404 or address-not-found error
- Insufficient payment or failed USDC transaction results in a payment failure response
- Box does not exist for the given address — box must be created first via the box create endpoint
- Malformed address format causes a validation error
- Network or blockchain congestion may cause delayed confirmation

## Output

Returns a confirmation that the agent box has been topped up, including the updated balance or credit amount and a transaction reference for the payment made to the box.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-box-top-up-cc90aea1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arcgate.dev](https://www.zero.xyz/host/api.arcgate.dev/llms.txt)