{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.yuan","code":"thing-q25530138","url":"https://ver.cy/models/thing/q25530138/","name":"yuan","alternateNames":["Chinese National Currency","Jiangnan yuan","Chinese yuan","New Taiwan Dollar coins"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Cross-cutting context","entryKind":"thing","plane":"XCT","domain":["XCT.QTY"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"The basic unit of currency in China, the yuan of the renminbi (CNY), and historically a name for various Chinese silver dollars and currencies; the word yuan is also used for the New Taiwan dollar in Chinese.","purpose":"Let an agent handle the yuan by currency, denominations, exchange, payment practices and history, without financial or investment advice.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Unit of the renminbi","Managed exchange rate","Heavy mobile payment use","Historical meanings"],"structure":{"bundles":[{"id":"currency","name":"Currency","description":"Which yuan.","layers":[{"id":"terms","name":"Terms","description":"Yuan and renminbi.","findings":[{"id":"terms-finding","name":"Terms","description":"Terminology.","questions":[{"text":"Is the renminbi yuan, offshore yuan or a historical yuan meant?","kind":"definition"},{"text":"How do yuan and renminbi differ?","kind":"definition"}]}]},{"id":"denominations","name":"Denominations","description":"Notes and coins.","findings":[{"id":"denominations-finding","name":"Denominations","description":"Denominations.","questions":[{"text":"Which notes and coins are in circulation?","kind":"provenance"},{"text":"What security features does the issuer describe?","kind":"provenance"}]}]}]},{"id":"exchange","name":"Exchange","description":"Rates.","layers":[{"id":"rate","name":"Rate","description":"Reference rate.","findings":[{"id":"rate-finding","name":"Rate","description":"Exchange rate.","questions":[{"text":"What is the official reference rate, and from which source?","kind":"provenance"},{"text":"How do CNY and CNH rates differ?","kind":"definition"}]}]},{"id":"rules","name":"Rules","description":"Controls.","findings":[{"id":"rules-finding","name":"Rules","description":"Exchange rules.","questions":[{"text":"What rules apply to exchanging or transferring yuan?","kind":"provenance"},{"text":"Which authority sets them?","kind":"provenance"}]}]}]},{"id":"travel","name":"Travel","description":"Paying in China.","layers":[{"id":"payments","name":"Payments","description":"Mobile payments.","findings":[{"id":"payments-finding","name":"Payments","description":"Payment practices.","questions":[{"text":"Which payment methods can visitors use in China?","kind":"provenance"},{"text":"Are foreign cards accepted?","kind":"provenance"}]}]},{"id":"cash","name":"Cash","description":"Cash use.","findings":[{"id":"cash-finding","name":"Cash","description":"Cash.","questions":[{"text":"Is cash widely accepted?","kind":"provenance"},{"text":"Where can cash be withdrawn?","kind":"provenance"}]}]}]},{"id":"limits","name":"Limits","description":"Advice.","layers":[{"id":"advice","name":"Advice","description":"Trading.","findings":[{"id":"advice-finding","name":"Advice","description":"Advice limit.","questions":[{"text":"Is the user asking whether to buy or sell yuan?","kind":"boundary"},{"text":"How should they be referred to a licensed adviser?","kind":"action"}]}]},{"id":"history","name":"History","description":"Currency history.","findings":[{"id":"history-finding","name":"History","description":"History.","questions":[{"text":"How has the yuan developed historically?","kind":"provenance"},{"text":"Which sources document it?","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Report yuan exchange rates with their source and timestamp.","Distinguish the renminbi yuan from the New Taiwan dollar and historical yuan currencies."],"mustNot":["Give personal investment or currency trading advice.","Present an outdated or unofficial exchange rate as current.","Assist in counterfeiting notes or passing counterfeit money.","Help move money in ways that evade currency controls or sanctions."],"requiresHuman":["Making a currency exchange or payment on someone's behalf."]},"ethics":{"considerations":["Wrong exchange rates cost travellers, traders and migrants who send money home.","Counterfeit notes harm the people who end up holding them."],"affectedParties":["Holders and users of the currency","Traders and travellers"]},"owners":{"steward":"The issuing central bank of the currency.","roles":[],"masterSystems":[]},"relations":[{"target":"Q8142","type":"parent","note":"registry parent class"},{"target":"currency","type":"related","note":"category"},{"target":"People Bank of China","type":"related","note":"issuer"},{"target":"yen and won","type":"related","note":"related currency names"},{"target":"China","type":"related","note":"country"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.yuan","Wikidata: Q25530138 (https://www.wikidata.org/wiki/Q25530138)","ISO 4217: CNY (156) currency code"]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Symbol and ISO code CNY","Offshore trading code CNH","The Japanese yen is a different currency","Banknotes and coins issued by the People Bank of China; mobile payments dominate everyday use."]},"capabilities":{"applicability":"required","items":["distinguish yuan and renminbi","identify notes and coins","find official exchange rate references","understand payment practices in China"]},"hazards":{"applicability":"required","items":["Agents giving investment advice","Outdated exchange rates","Counterfeit notes"]},"interfaces":{"applicability":"required","items":["ISO 4217","Chinese foreign exchange regulations","Anti-money-laundering rules"]},"context":{"applicability":"required","items":["Payments in China and international trade.","renminbi yuan (CNY)","offshore yuan (CNH)","historical yuan currencies","yuan as Chinese name for other dollars"]}},"sources":[{"title":"Wikidata item Q25530138: yuan","url":"https://www.wikidata.org/wiki/Q25530138","note":"identity and sense of the item"},{"title":"Wikipedia: Yuan (currency)","url":"https://en.wikipedia.org/wiki/Yuan_%28currency%29","note":"general description of the item"}],"openQuestions":["Should CNY and CNH be separate entries?","How should exchange rates be sourced?","How should historical yuan be linked?"],"resources":{"spec":"/models/things/publications/thing-q25530138/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q25530138/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T11:32:52Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-06T19:51:57+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane XCT: no invented physical properties."},"score":1.0}}