{"uid":"cap_JjfdSIzrUzLgJllNFRGdr","slug":"livecheck-watcher-chain-top-up-e0a5cf7c","name":"Livecheck Watcher Chain Top-Up","description":"Before you scrape a job posting, Shopify or HTML product page, or eBay item, POST the specific URL you already have and Livecheck returns live, closed, or unknown plus title and signals (apply form, in-stock, sold-out, 404); not a search engine.","url":"https://livecheck.fly.dev/v1/watch/%7Bid%7D/chain/topup","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","added_usd","chain_balance_usd","price_usd","run"],"properties":{"id":{"type":"string","description":"Watcher id (wtc_ + ULID)."},"run":{"enum":["none","verify","confirm"],"type":"string"},"added_usd":{"type":"number"},"price_usd":{"type":"number"},"chain_budget_usd":{"type":["number","null"]},"chain_balance_usd":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"id":"wtc_01J8Z0K3N4P5Q6R7S8T9V0WWTC","run":"verify","added_usd":0.5,"price_usd":0.5,"chain_budget_usd":5,"chain_balance_usd":0.5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9LYamnZTvztdq7v2rEYfT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds USDC credit to an existing Livecheck watcher's chain budget so it can continue running scheduled verification checks.","exampleAgentPrompt":"Top up watcher wtc_01J8Z0K3N4P5Q6R7S8T9V0WWTC with another $0.50 so it keeps running its verification checks.","exampleUseCases":[{"title":"Refuel a job listing monitor","prompt":"My Livecheck watcher for that job posting is about to run dry — top up watcher wtc_01J8Z0K3N4P5Q6R7S8T9V0WWTC with $0.50 so it keeps checking whether the role is still live."},{"title":"Extend product availability watch","prompt":"I set up a watcher to monitor whether that Shopify product is in stock, but the chain balance is almost zero. Add $0.50 to watcher wtc_01J9ABCDEF1234567890XYZWTC so it doesn't stop running."},{"title":"Keep eBay listing watch active","prompt":"My eBay item watcher is going to stop soon — can you top up chain balance for watcher wtc_01JABC9876ZYXWVU54321QWTC with another $0.50?"}],"resultDescription":"Returns the watcher ID, the amount added in USD, the updated chain balance in USD, the per-check price in USD, the total chain budget in USD, and the current run status (none or verify).","failureModes":["Invalid or non-existent watcher ID returns an error","Insufficient payment (below $0.50 per-call price) causes payment rejection","Malformed watcher ID format (not wtc_ + ULID) returns validation error","Watcher already expired or deleted may return not-found error","Payment gateway failure or x402 protocol error prevents top-up"],"whenToPreferThis":"Use this endpoint when you already have an active Livecheck watcher (wtc_ ID) whose chain balance is low or exhausted and you want to refill its budget so scheduled verification runs continue uninterrupted. This is not for creating new watchers or performing one-shot checks — use the /v1/watch or /v1/check endpoints for those.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:18.929Z","isFirstParty":false}