BUSINESS CASES
Where this module fits
- reference valuation
- multi-source price provenance
- freshness and quality monitoring
- signed price-evidence replay
- delivery entitlement and usage review
DOCUMENTATION
v2BUILD · MODULE 21
Price Feeds
Discover canonical price feeds, inspect their provider composition and aggregation policy, read the latest signed observation, and replay entitled evidence without exposing workspace ownership or internal delivery identifiers.
PRIMARY CONSUMERS
Who integrates it
- market-data clients
- treasury and valuation systems
- risk engines
- pricing agents
- audit and reconciliation tools
PREREQUISITES
What must exist first
- a bearer credential with pricing:read
- a supported canonical instrument mapping
- an active or paused subscription for replay
- a business-specific maximum age and acceptable quality policy
RECOMMENDED WORKFLOW
Compose the module safely.
- 01
list feeds and select the canonical instrument plus quote asset
- 02
inspect cadence, provider composition, aggregation policy, and failover posture
- 03
read the latest snapshot and evaluate health, age_ms, quality_state, and chain_state before use
- 04
use an entitled subscription to replay signed observations in sequence order
- 05
advance with next_after_sequence and distinguish window_exceeded from a genuinely empty result
MODULE CONTRACTS
Every mapped endpoint
Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.
GETList delivery plans
/api/v2/price-feed-plansList active price-delivery plans and the feed, connection, cadence, replay-window, and retention limits agents must evaluate before planning a subscription.›GETList subscriptions/api/v2/price-feed-subscriptionsList the authenticated workspace's delivery entitlements, replay limits, lifecycle posture, billing posture, and current-month transport usage.›POSTCreate subscription/api/v2/price-feed-subscriptionsCreate an ACTIVE owner-scoped delivery contract with exact feed entitlements, plan limits, metered-service posture, and retained retry semantics.›GETGet subscription/api/v2/price-feed-subscriptions/{subscription_uuid}Return one workspace-owned delivery contract with lifecycle timestamps, plan limits, entitled feeds, current-month usage, and commercial contract posture.›PATCHUpdate subscription/api/v2/price-feed-subscriptions/{subscription_uuid}Pause, resume, or terminally cancel one owner-scoped delivery contract and retain the resulting lifecycle evidence.›POSTCreate access ticket/api/v2/price-feed-ticketsPlanned capability: plan short-lived scoped ticket issuance. No public ticket issuer exists in the authoritative owner yet.›GETList feeds/api/v2/price-feedsList public feeds plus workspace-owned composites with canonical instruments, provider composition, cadence, aggregation policy, and failover posture.›GETGet feed/api/v2/price-feeds/{feed_uuid}Return one workspace-visible feed and the exact source and policy context needed to interpret its normalized observations.›GETReplay signed feed evidence/api/v2/price-feeds/{feed_uuid}/historyReplay subscription-entitled signed observations in feed-local sequence order with explicit cursor and retention-window diagnostics.›GETGet latest signed snapshot/api/v2/price-feeds/{feed_uuid}/snapshotReturn the latest signed observation together with health, age, cadence, quality, and hash-chain evidence.›POSTCreate composite/api/v2/price-feeds/compositesRegister an owner-scoped, DataStream-backed composite from two through eight verified direct provider mappings without granting publication or trading authority.›GETList prices/api/v2/explorer/pricesList prices from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet price/api/v2/explorer/prices/{evidence_uuid}Return the verification projection for price from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet price record/api/v2/explorer/prices/{uuid}Return prices uuid from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›