{"uid":"cap_R6sOR3loV1wpiIDw7BJwQ","slug":"seneschal-private-watch-top-up-baf5b89f","name":"Seneschal Private Watch Top-Up","description":"Add $0.10 of credit (100_000 atomic USDC) to an existing watch. Body: { watchId, watchToken }. Returns the post-top-up credit block.","url":"https://api.seneschal.space/v1/private/topup","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bWT4e0YoMv8_TljTATVNT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Add credit to an existing Seneschal private watch monitor for Monero or Zcash payment detection, extending its active watching period.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:35.218Z","isFirstParty":false}