{"tool":"reality-monitor","title":"RealityGraph Monitor Check","what":"One bounded monitoring check of an entity: the current fingerprint of its core facts (country, headquarters, website, CEO, employees, revenue, population, version ... by kind), changed true or false against the fingerprint you kept, the facts that differ from YRUZ's previous observation, and the source's latest revision. No subscription: each check is one paid call.","endpoint":"https://yruz.one/api/reality/monitor","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.003"},"params":[{"name":"id","required":true,"description":"Wikidata id, e.g. Q7624104","example":"Q7624104"},{"name":"fingerprint","required":false,"description":"fingerprint returned by your previous check (optional)","example":null}],"valid_request":{"get":"https://yruz.one/api/reality/monitor?id=Q7624104","post":{"url":"https://yruz.one/api/reality/monitor","body":{"id":"Q7624104"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"product":"string","task":"string","task_version":"number","api_version":"string","data":{"record":"string","fingerprint":"string","changed":"null","compared_with":"string","watched":{"P31":["string"],"P17":["string"],"P571":["string"],"P856":["string"],"P159":["string"],"P1448":["string"],"P112":["string"],"P169":["string"],"P1128":["string"],"P452":["string"],"P1278":["string"],"P749":["string"],"P355":["string"],"P1454":["string"],"P740":["string"]},"changes_since_previous_observation":[],"observed":{"available":"boolean","first_observed_at":"string","last_changed_at":"null","observations":"number","changed_since_last_observation":"null"},"id":"string","kind":"string","source_revision":{"revision":"number","at":"string"}},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":[],"retrieved_at":"string","retrieved_until":"string","served_from_cache":"boolean","licence":"string","attribution":"string"}],"data_as_of":"string","freshness_status":"string","coverage":"null","partial":"boolean","warnings":[],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"},"history":{"kind":"string","note":"string"}},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"reality-resolve","url":"https://yruz.one/api/reality/resolve","why":"which entity is this","usd":"0.01","how":"https://yruz.one/api/instructions?tool=reality-resolve"},{"tool":"reality-evidence","url":"https://yruz.one/api/reality/evidence","why":"sourced facts with references","usd":"0.02","how":"https://yruz.one/api/instructions?tool=reality-evidence"},{"tool":"reality-conflicts","url":"https://yruz.one/api/reality/conflicts","why":"where sources disagree","usd":"0.02","how":"https://yruz.one/api/instructions?tool=reality-conflicts"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}