Public HTTP API for PDC Oracle. Base URL:
https://oracle.privacydatacoin.com
User overview and PDCx fee wrap: Oracle. Paid tip path: Paid attestation. Trade’s mirrored USD book: Trade API.
Endpoints
| Method | Path | Auth | Notes |
|---|---|---|---|
| GET | /api/health |
none | Liveness, sequence, status, feature flags |
| GET | /api/prices/usd |
none | Trade-compatible book + signature envelope (schemaVersion 1) |
| GET | /api/prices/feed |
none | Full signed document (same schema family as /usd) |
| GET | /api/prices/streams |
none | Additive Streams-style report (schema v2) — not a replacement for /usd |
| GET | /api/prices/evm |
none | Optional EVM Aggregator-style report — additive |
| GET | /api/methodology |
none | Public price methodology (JSON) — venues, quorum, pair rules |
| GET | /methodology |
none | Same methodology as HTML |
| GET | /api/sidechain/attestation |
optional Bearer | CA tip attestation (when enabled) |
| GET | /api/sidechain/evm |
optional Bearer | Sidechain→EVM report (when enabled) |
| POST | /api/admin/refresh |
admin token | Force refresh — must stay private |
Trade consumers should use /api/prices/usd (schema v1) only for signature verification. Streams / EVM / sidechain are optional extras. Methodology is unsigned policy text (not a signed price book).
Prices USD (schema v1)
curl -sS 'https://oracle.privacydatacoin.com/api/prices/usd'
| Field | Meaning |
|---|---|
schemaVersion |
1 for the Trade feed |
updatedAt |
Unix seconds of the publish |
prices |
Map of ticker → USD float (BTCX, PDC, ARQX, ETH, BNB, SOL, ZEC, XMR, DASH, …) |
pairs |
Explicit pair keys (BTC_USD, BTCX_USD, PDC_USD, ETH_USD, …, PDC_BTCX, …) |
status |
verified | degraded | unavailable (verified needs BTC primary quorum ≥ 3) |
sequence |
Monotonic publish counter |
maxAgeSec |
Soft freshness window (often 120) |
signature |
Ed25519 signature (URL-safe base64) |
publicKey |
Publisher pubkey hex (pin out-of-band; do not blindly trust) |
Live public key (pin this)
Current production publisher key (also returned in feed JSON):
cc0e662c6d757856cda001744fbaa819d86aff26e1407695d90249c1a455c21e
Rotate only with an explicit ops process. Trade pins the same value as ORACLE_PUBLIC_KEY_HEX.
Health
curl -sS 'https://oracle.privacydatacoin.com/api/health'
Useful fields: ok, hasFeed, sequence, status, updatedAt, adminProtected, optional sidechainAttestation / sidechainRound.
Verification checklist (integrators)
- Fetch
/api/prices/usdover HTTPS. - Confirm
schemaVersion === 1. - Verify Ed25519
signatureover the canonical payload (field order / sorted maps as in the publishersignmodule) with your pinned public key — not merely equality of thepublicKeystring in the body. - Reject if age
now - updatedAtexceedsmaxAgeSec(or your stricterORACLE_CONSUMER_MAX_AGE_SEC). - Reject if
sequenceis not greater than the last accepted sequence. - Prefer
status=verified; decide policy fordegraded.
Reference consumer: Trade oracle-feed module in pdc_trade_backend (docs/oracle-feed-integration.md).
Trade consumer flags (operators)
When Trade points at Oracle:
| Variable | Role |
|---|---|
ORACLE_FEED_ENABLED |
Prefer signed Oracle |
ORACLE_FEED_URL |
Default https://oracle.privacydatacoin.com/api/prices/usd |
ORACLE_PUBLIC_KEY_HEX |
Required pin (64 hex chars) |
ORACLE_LEGACY_FALLBACK |
If 1, fall back to unsigned legacy on failure; else fail closed |
ORACLE_FEED_TIMEOUT_MS |
Fetch timeout (default 8000) |
Rollback: disable ORACLE_FEED_ENABLED and restart Trade.
Methodology (public)
curl -sS 'https://oracle.privacydatacoin.com/api/methodology'
# HTML: https://oracle.privacydatacoin.com/methodology
Documents the live policy: primary CEX (Binance, Kraken, Coinbase, Bitstamp, OKX, Bybit), BTC quorum 3, Gecko/CMC as BTC/pair backup only, PDC_USD from Trade trade_book (not a fixed manual default), majors (ETH/BNB/SOL) and privacy (ZEC/XMR/DASH). Narrative: Oracle.
Additive APIs (optional)
| Path | Role |
|---|---|
/api/prices/streams |
Quorum + per-venue observations (schema v2) |
/api/prices/evm |
Optional secp256k1 Aggregator-style report for EVM tip contracts |
/api/sidechain/attestation |
Disclosable CA tip attestation (paid product; may require Bearer) |
/api/sidechain/evm |
Sidechain→EVM tip report for updateAttestation |
These must not replace schema v1 verification for Trade USD labels.
Paid sidechain attestation
Narrative and user/integrator checklist: Paid attestation.
Read (no L1 debit on GET)
curl -sS 'https://oracle.privacydatacoin.com/api/sidechain/attestation'
curl -sS 'https://oracle.privacydatacoin.com/api/sidechain/evm'
| Field (typical) | Meaning |
|---|---|
schemaVersion |
ca-1 (attestation) / ca-evm-1 (EVM report) |
height / roundId |
Tip height and publish round |
feeAmount |
Atomic fee (1000000 = 0.01 @ 8 decimals on mainnet) |
feeAssetId |
L1 PDCx asset id (64 hex) |
feeRecipient |
EVM treasury / @dev — not wrap mint custody |
feeTreasuryPdcAddress |
L1 Px hint for treasury |
ethSignature / reportHash |
Inputs for on-chain updateAttestation |
signerAddress |
secp256k1 reporter |
Optional: Authorization: Bearer <SIDECHAIN_API_TOKEN> when the operator enabled a token.
Pay (on-chain)
- Acquire PDCx on L1 if needed: Bridge PDC→PDCX.
- On the attestation EVM (private Clique soak for operators):
approvethe fee token, thenupdateAttestation(...). - Confirm
latestTip()onPdcSidechainAttestationTokenFee.
HTTP alone does not pull L1 PDCx. The contract transferFrom is the hard fee gate. Mainnet fee amount and go-live notes: publisher docs/oracle-attestation-fee-go-live.md.
Related
- oracle.privacydatacoin.com — dashboard
- Methodology — venues and quorum
- Oracle — user guide, status, PDCx fees
- Paid attestation — how payment works end-to-end
- Trade API — Trade HTTP including
/api/prices/usd - Bridge — PDC→PDCX wrap
- Architecture / threat model: oracle repo docs