{"tool":"reality-history","title":"RealityGraph Fact History","what":"Time-aware history of an entity: the source's revision log (when, which properties, which kind of edit), when the entity was created, and with as_of the facts the source stated at that past date compared to today (changed, added, removed per property). Plus attribute changes YRUZ observed itself. Source revision dates are when a claim was recorded, not when it became true; effective dates come from qualifiers.","endpoint":"https://yruz.one/api/reality/history","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.008"},"params":[{"name":"id","required":true,"description":"Wikidata id, e.g. Q7624104","example":"Q7624104"},{"name":"as_of","required":false,"description":"past date YYYY-MM-DD to compare with now","example":"2023-01-01"},{"name":"property","required":false,"description":"only edits of this property, e.g. P1128","example":null},{"name":"limit","required":false,"description":"revisions, 1-50 (default 25)","example":null},{"name":"lang","required":false,"description":"language of labels, 2-3 letters (default en)","example":null}],"valid_request":{"get":"https://yruz.one/api/reality/history?id=Q7624104&as_of=2023-01-01","post":{"url":"https://yruz.one/api/reality/history","body":{"id":"Q7624104","as_of":"2023-01-01"}}},"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":{"id":"string","created_at_source":"string","revisions":[{"revision":"number","at":"string","edit":"string","properties":["…"],"size_change":"number"}],"revisions_returned":"number","filter_property":"null","as_of":{"date":"string","available":"boolean","source_revision_then":{"revision":"number","at":"string"},"value_labels":{"Q17074350":"string","Q4830453":"string","Q837171":"string","Q12738586":"string","Q30":"string","Q27":"string","Q62":"string","Q927122":"string","Q1589009":"string","Q57655560":"string","Q149789":"string","Q64":"string","Q47265":"string"},"source_revision_now":{"revision":"number","at":"string"},"core_facts_compared":"number","unchanged":"number","changes":[{"…":"…"}],"note":"string"},"observed_changes":[],"dates":"string"},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":["string"],"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":["string"],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"},"history":{"kind":"string","record":{"first_observed_at":"string","last_observed_at":"string","last_changed_at":"null","observations":"number"}}},"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"}}