{"uid":"cap_6lH1kYiqjO1AtBAx50xAz","slug":"seneschal-data-freshness-check-c62db5b8","name":"Seneschal Data Freshness Check","description":"Single-fact: age in seconds of the freshest record in the named source (shadow_blocks|borrower_snapshot|morpho_borrower_snapshot|missed_liquidations|executions).","url":"https://api.seneschal.space/v1/q/data-freshness","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"},"queryParams":{"type":"object","required":["source"],"properties":{"source":{"type":"string","description":"One of shadow_blocks|borrower_snapshot|morpho_borrower_snapshot|missed_liquidations|executions."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"age_s":{"type":"number"},"source":{"type":"string"},"mtime_ms":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"age_s":42.5,"source":"borrower_snapshot","mtime_ms":1765531957500}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j206FTMMuht49KBk6nFz2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns metadata about how current the Seneschal service's data is, useful for verifying API health and data staleness before relying on payment watch or block builder outputs.","exampleAgentPrompt":"Check how fresh the data is on Seneschal right now — I want to make sure the Monero and Zcash payment watch data isn't stale before I rely on it.","exampleUseCases":null,"resultDescription":"Returns an object indicating the freshness or last-updated timestamp of the Seneschal service's data, allowing callers to assess whether the underlying payment watch or block builder data is current.","failureModes":["Invalid or malformed properties parameter returns 400 error","Service unavailable returns 503","Payment required (402) if USDC balance is insufficient","Stale data indicated if backend indexer is behind","Empty or null response if no freshness data is available"],"whenToPreferThis":"Use this endpoint before relying on any Seneschal data (Monero/Zcash payment watches, Ethereum block builder telemetry) to confirm the service is live and data is fresh. Prefer this over generic health checks when you need to know specifically about data recency rather than just uptime.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:40.828Z","isFirstParty":false}