{"tool":"reality-entity","title":"RealityGraph Entity Profile","what":"Normalized profile of one entity: label, description, aliases, types, official identifiers (LEI, ticker, VIAF, OpenCorporates, national registers ...), and the core facts for its kind (inception, country, headquarters, website, founders, CEO, employees and revenue over time, industry, population, licence, version ...). Every fact keeps rank, qualifiers (start, end, point in time), reference count and a status: observed, observed_unsourced, historical, deprecated or conflicting. Extra properties on request.","endpoint":"https://yruz.one/api/reality/entity","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.004"},"params":[{"name":"id","required":false,"description":"Wikidata id (required unless q), e.g. Q7624104","example":"Q7624104"},{"name":"q","required":false,"description":"name instead of id (the top search hit is used and reported)","example":null},{"name":"properties","required":false,"description":"extra property ids, comma separated, up to 15, e.g. P1056,P2403","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/entity?id=Q7624104","post":{"url":"https://yruz.one/api/reality/entity","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":{"id":"string","kind":"string","label":"string","description":"string","aliases":[],"types":[{"id":"string","label":"string"}],"identifiers":[{"property":"string","label":"string","values":["…"]}],"identifiers_total":"number","facts":[{"property":"string","label":"string","statements":["…"],"statements_total":"number","assessment":"string","current":["…"]}],"not_stated":["string"],"sitelinks":{"count":"number","wikipedia":{"enwiki":"string","dewiki":"string","frwiki":"string","eswiki":"string","itwiki":"string","jawiki":"string","zhwiki":"string"}},"last_source_revision":{"revision":"number","at":"string"},"url":"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":"string","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","note":"string","available":"boolean","first_observed_at":"string","last_changed_at":"null","observations":"number","changed_since_last_observation":"boolean","changes":[]}},"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"}}