{"uid":"cap_Rzz2JvDRaKmwuo0v5xkmH","slug":"watchlist-diff-26116dc1","name":"Watchlist Diff","description":"Retention in one call: pass up to 10 tokens to snapshot them and get a watchId; call again with that watchId to get only the DELTAS since last time — liquidity ±%, price ±%, became-honeypot, sell-tax spiked, liquidity pulled. The second call is worth more than the first. Built for agents holding positions that re-check daily.","url":"https://402.com.tr/api/x402/watchlist-diff?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":[],"properties":{"tokens":{"type":"string","description":"Up to 10 token addresses (comma-separated)"},"watchId":{"type":"string","description":"Or: watchId to re-check an existing list"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cPQO6qms-KQmq59CcwFW8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Snapshots up to 10 token addresses and returns only the deltas (liquidity, price, honeypot status, sell-tax, liquidity pulls) since the last check via a watchId.","exampleAgentPrompt":"Start tracking these five token addresses for me — 0xABC..., 0xDEF..., 0x123..., 0x456..., 0x789... — and then tomorrow check them again and tell me only what changed: any liquidity moves, price swings, sell-tax spikes, or if any turned into a honeypot.","exampleUseCases":[{"title":"Daily rug-pull risk check for held positions","prompt":"I'm holding positions in these three tokens on Base — 0xToken1, 0xToken2, 0xToken3. Create a watchlist for them now, and then tomorrow re-check using the watchId and tell me if any liquidity was pulled, sell-tax spiked, or one of them became a honeypot overnight."},{"title":"DeFi portfolio safety monitoring agent","prompt":"I want to monitor my 8-token DeFi portfolio for sudden risk changes — here are the addresses: 0xA1, 0xB2, 0xC3, 0xD4, 0xE5, 0xF6, 0xG7, 0xH8. Snapshot them now and every 24 hours give me only the deltas — what changed in liquidity, price, or safety status."},{"title":"Post-trade honeypot and liquidity surveillance","prompt":"I just bought into 0xNewToken and want to keep an eye on it alongside 0xExistingToken1 and 0xExistingToken2. Add them to a watchlist and check back with that watchId in a few hours to see if anything suspicious happened — liquidity drop, tax spike, or honeypot flag."}],"resultDescription":"On the first call (with token addresses), returns a watchId and a baseline snapshot of each token's liquidity, price, and safety status. On subsequent calls (with watchId), returns only the deltas since the last check — percentage changes in liquidity and price, newly flagged honeypot status, sell-tax spikes, and liquidity pull events. Unchanged tokens are omitted, making the second call the high-signal result.","failureModes":["Invalid or expired watchId returns an error — watchIds may have a TTL and must be re-initialized","More than 10 token addresses causes the request to fail or be truncated","Invalid token address format (non-checksummed or wrong chain) returns no data for that token","Network or RPC errors fetching on-chain state may cause partial results","First call returns baseline only, not deltas — agent must store watchId and call again to get meaningful diff data"],"whenToPreferThis":"Choose this endpoint when an agent needs to repeatedly monitor a fixed set of tokens for risk changes (honeypot, liquidity pull, tax spike) without re-fetching full data each time. The delta model is ideal for daily or periodic re-checks where only changes matter, minimizing cost and noise. Prefer this over one-off token safety checks when the agent is holding positions and needs ongoing surveillance rather than a single point-in-time assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T00:44:48.497Z","isFirstParty":false,"canonicalSlug":"watchlist-diff-26116dc1"}