# Seneschal Private Watch Top-Up

> Seneschal Private Watch Top-Up is a paid API for AI agents from api.seneschal.space, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Add credit to an existing Seneschal private watch monitor for Monero or Zcash payment detection, extending its active watching period.

## Facts

- Endpoint: POST https://api.seneschal.space/v1/private/topup
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seneschal-private-watch-top-up-baf5b89f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R6sOR3loV1wpiIDw7BJwQ

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 seneschal-private-watch-top-up-baf5b89f -d '<json body>'
```

Example prompt: Top up my Seneschal private watch — the watch ID is watch_abc123 and the token is tok_xyz789 — so it keeps monitoring my Monero address for incoming payments.

## When to prefer this

Use this endpoint when you have an existing Seneschal watch that needs additional credit to continue monitoring a Monero or Zcash address for incoming payments, and you want to pay via x402 USDC on Base. Prefer this over creating a new watch when the watch already exists and just needs more runtime budget.

## Known failure modes

- Invalid watchId returns 404 not found
- Invalid or missing watchToken returns 401 unauthorized
- Insufficient x402 USDC payment on Base triggers 402 Payment Required
- Watch already expired or deleted may return 410 Gone
- Malformed request body returns 400 Bad Request

## How this service works

Add $0.10 of credit (100_000 atomic USDC) to an existing watch. Body: { watchId, watchToken }. Returns the post-top-up credit block.

## Output

Confirmation that the watch has been funded/extended with additional credit, allowing continued monitoring of the Monero or Zcash address for incoming transactions and subsequent webhook delivery.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "watchId": {
   "type": "string",
   "description": "Watch identifier from POST /v1/private/watch."
  },
  "watchToken": {
   "type": "string",
   "description": "Bearer credential returned at watch creation. Secret."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tier": "/v1/private/topup",
  "credit": {
   "billed_usd": "$0.005",
   "low_credit": false,
   "topups_usd": "$0.10",
   "billed_atomic": "5000",
   "remaining_usd": "$0.12",
   "topups_atomic": "100000",
   "rate_per_day_usd": "$0.02",
   "remaining_atomic": "120000",
   "rate_per_call_usd": "$0.005",
   "rate_per_day_atomic": "20000",
   "rate_per_call_atomic": "5000",
   "days_remaining_if_idle": 6,
   "low_credit_threshold_usd": "$0.04",
   "low_credit_threshold_atomic": "40000"
  },
  "watchId": "w_3f9c2e1a",
  "expiresAt": "2026-07-12T00:00:00.000Z",
  "creditAppliedAtomic": "100000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seneschal-private-watch-top-up-baf5b89f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seneschal.space](https://www.zero.xyz/host/api.seneschal.space/llms.txt)