{"schemaVersion":1,"title":"PDC Oracle USD price methodology","summary":"BTC and BTCX USD are the median of independent primary exchange venues.\n\nETH, BNB, SOL, and the privacy cohort (ZEC, XMR, DASH) use the same primary CEX median. Configured secondary backups apply only when a pair has no successful primary sample (primarySucceeded === 0).\n\nPDC_USD and ARQX_USD use the live Trade order book (BTCX↔PDC and BTCX↔ARQX) and other independent quotes where available.\n\nFeed status verified requires a BTC primary quorum of at least 3 venues (majors pair quorum 3; privacy pair quorum 2).","pairs":[{"id":"BTC_USD","description":"Spot Bitcoin USD from primary CEX tickers (USDT≈USD where noted)."},{"id":"BTCX_USD","description":"1:1 wrapped BTC reference for Trade; same samples as BTC_USD."},{"id":"ETH_USD","description":"Ethereum USD — primary CEX median; secondary backup only when primarySucceeded === 0."},{"id":"BNB_USD","description":"BNB (BSC native) USD — primary CEX median where listed; soft-skip venues without the pair."},{"id":"SOL_USD","description":"Solana USD — primary CEX median; secondary backup only when primarySucceeded === 0."},{"id":"ZEC_USD","description":"Zcash USD — privacy cohort; primary CEX median; lower pair quorum."},{"id":"XMR_USD","description":"Monero USD — privacy cohort; soft-skip geofenced/delisted venues; backup when primary=0."},{"id":"DASH_USD","description":"Dash USD — privacy cohort; primary CEX median; lower pair quorum."},{"id":"PDC_USD","description":"PrivacyDataCoin USD from Trade open book vs BTCX (BTCX↔PDC). Optional PDC_USD_PRICE is an emergency fallback only (not the normal path)."},{"id":"ARQX_USD","description":"ARQX USD — median of independent quotes and the Trade book vs BTCX when available."},{"id":"PDC_BTCX","description":"Cross rate PDC_USD / BTCX_USD."},{"id":"ARQX_BTCX","description":"Cross rate ARQX_USD / BTCX_USD."}],"btcPrimary":{"role":"Authoritative BTC/BTCX samples (feed-level quorum)","venues":["binance","kraken","coinbase","bitstamp","okx","bybit"],"quorum":3,"quorumRule":"status=verified only when BTC primarySucceeded >= 3 (default 3-of-N)."},"btcBackup":{"role":"Emergency BTC/BTCX only","venues":["coingecko","coinmarketcap"],"rule":"Secondary aggregators queried for BTC only when primarySucceeded === 0. Feed is then degraded (quorum unmet)."},"majorUsd":{"pairs":["ETH_USD","BNB_USD","SOL_USD"],"role":"Phase-1 major USD pairs","venues":["binance","kraken","coinbase","bitstamp","okx","bybit"],"quorum":3,"backupRule":"Per pair: secondary aggregators only when that pair primarySucceeded === 0. Soft-skip venues without the market."},"privacyUsd":{"pairs":["ZEC_USD","XMR_USD","DASH_USD"],"role":"Phase-2 privacy USD pairs","venues":["binance","kraken","coinbase","bitstamp","okx","bybit"],"quorum":2,"backupRule":"Per pair: secondary aggregators only when that pair primarySucceeded === 0. Soft-skip 404/empty (esp. XMR).","note":"Pair quorum default ORACLE_MIN_SOURCES_PRIVACY=2; does not replace BTC feed quorum. Coverage monitoring: health/streams expose per-pair primarySucceeded, coverageWarn (primary < min), and backupOnly; oracle logs warn when XMR_USD primarySucceeded is below that min (thin CEX / backup-only)."},"pdc":{"sources":["trade_book"],"note":"Trade book derives PDC_USD from open BTCX↔PDC orders × BTCX_USD (normal path). Optional env PDC_USD_PRICE (signed as manual_env) is emergency-only and replaces trade_book PDC_USD — it is not median-blended with the book. Leave unset in production with a live book."},"arqx":{"sources":["coingecko","coinmarketcap","trade_book"],"note":"Median of at least two independent ARQX inputs when backups and/or the Trade book are available."},"status":{"verified":"Required pairs present and BTC primary quorum met.","degraded":"Missing optional pair (e.g. ARQX) and/or BTC primary quorum unmet (including BTC-backup-only). Optional ETH/BNB/SOL/ZEC/XMR/DASH misses do not alone degrade.","unavailable":"No valid BTCX_USD — publish refused (fail-closed)."},"configured":{"btcSources":["binance","kraken","coinbase","bitstamp","okx","bybit"],"btcBackupSources":["coingecko"],"minSourcesForVerified":3,"minSourcesForPrivacyVerified":2,"tradeApiUrl":"https://api.trade.privacydatacoin.com","cmcEnabled":false}}