{"uid":"cap_Z_VZ5PVGom6M4Z1UTO5dW","slug":"seneschal-private-watch-top-up-e6baa841","name":"Seneschal Private Watch Top-Up","description":"Pay-per-call services for the agent economy: a webhook the moment a Monero or Zcash payment lands at your address (view-key only), single-fact x402 data APIs, a paid public notice board, a stablecoin gas paymaster and a permissionless Ethereum block builder. No account, no API key — pay in USDC on Base or in XMR/ZEC.","url":"https://api.seneschal.space/v1/private/topup-1","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-1","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":"1000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QNzlZPPT7mYgiOxI_ZM8H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds credit to an existing Monero/Zcash payment watch subscription, keeping the watch active so webhooks continue to fire when payments arrive.","exampleAgentPrompt":"Top up my Seneschal watch with ID 'watch_abc123' using my watch token — I want to add $1 of credit so my Monero payment webhook keeps firing.","exampleUseCases":[{"title":"Prevent Monero watch from expiring","prompt":"My Monero address watch is running low on credit and I'm worried it'll stop sending webhooks before I receive an expected payment — can you add $2 of credit to watch ID 'watch_xmr99' using token 'tok_xmr99secret' so it stays active?"},{"title":"Top up Zcash webhook monitoring","prompt":"I've got a Zcash payment watch set up with ID 'watch_zec42' and token 'tok_zec42abc' — please add $5 of credit to it so my webhook keeps firing when ZEC payments arrive at my address."},{"title":"Recharge existing private address watcher","prompt":"My Seneschal watch subscription for a private coin address is about to run dry — top it up with $3 of credit using watch ID 'watch_priv77' and watch token 'tok_priv77xyz' so I don't miss any incoming payment notifications."}],"resultDescription":"Returns a confirmation that the watch has been credited, along with the updated balance or watch status, so the monitoring continues without interruption.","failureModes":["Invalid or expired watchToken returns 401 unauthorized","Unknown watchId returns 404 not found","Insufficient payment or failed x402 USDC transaction returns 402 payment required","Malformed request body returns 400 bad request","Watch already expired and cannot be recharged returns 409 or 422"],"whenToPreferThis":"Use this endpoint when you have an existing Seneschal private-coin address watch that needs more credit to continue delivering webhooks. Choose this over creating a new watch when the watchId and watchToken are already known and you simply need to extend/fund the existing subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:50.616Z","isFirstParty":false}