{"tool":"reality-resolve","title":"RealityGraph Resolve","what":"Entity resolution for a company or organization: from a name plus optional website domain, country, LEI or type, the candidate Wikidata entities with a transparent score, a confidence band (deterministic, high, medium, low), the matching and conflicting attributes, why each matched, and which extra input would disambiguate. Identifier matches (LEI, official website) are deterministic; names only rank. Never merges entities.","endpoint":"https://yruz.one/api/reality/resolve","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.01"},"params":[{"name":"name","required":true,"description":"entity name, e.g. Stripe","example":"Stripe"},{"name":"domain","required":false,"description":"official website domain, e.g. stripe.com","example":"stripe.com"},{"name":"country","required":false,"description":"country, ISO 2-letter code, e.g. US","example":"US"},{"name":"lei","required":false,"description":"Legal Entity Identifier, 20 characters","example":null},{"name":"type","required":false,"description":"company, organization, place, software or person","example":null}],"valid_request":{"get":"https://yruz.one/api/reality/resolve?name=Stripe&domain=stripe.com&country=US","post":{"url":"https://yruz.one/api/reality/resolve","body":{"name":"Stripe","domain":"stripe.com","country":"US"}}},"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":{"input":{"name":"string","domain":"string","country":"string","type":"string"},"best":{"id":"string","band":"string","ambiguous":"boolean"},"candidates":[{"id":"string","label":"string","kind":"string","types":["…"],"score":"number","band":"string","method":"string","found_by":["…"],"matching":["…"],"conflicting":["…"],"official_websites":["…"],"url":"string"}],"to_disambiguate_add":[],"scoring":"string","note":"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":"string","partial":"boolean","warnings":[],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"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-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"},{"tool":"reality-monitor","url":"https://yruz.one/api/reality/monitor","why":"has it changed","usd":"0.003","how":"https://yruz.one/api/instructions?tool=reality-monitor"}],"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"}}