Pricing & Oracles
The distinct roles of underlying-equity quotes, per-token onchain feeds and corporate-action multipliers.
#Three values with different meanings
| Surface | Value | Multiplier treatment |
|---|---|---|
| Stock Token API /prices | Underlying-equity USD bid and ask | Raw; not multiplier-adjusted |
| Chainlink Stock Token feed | USD price of one Stock Token | Already multiplier-adjusted |
| Token /assets metadata or uiMultiplier() | Shares represented per raw token unit | The multiplier itself |
Stock Token feed price = underlying share price × uiMultiplier / 1e18Do not apply the multiplier twice. The onchain feed reports the full per-token value. Apply currentMultiplier only when converting a raw underlying-equity quote into token terms.
#Reading an onchain feed
- Read the per-asset Chainlink proxy through AggregatorV3Interface.
- Read decimals() rather than assuming a scale.
- Reject zero, negative or stale answers.
- Check Robinhood Chain sequencer uptime and use a recovery grace period.
- Treat oraclePaused() as an additional warning during corporate-action processing.
A feed can remain callable while its answer is stale. Timestamp, heartbeat and pause-state validation belong to the same price read.
#Payoff pricing
A reference price values exposure; it does not supply executable liquidity. ARRANGE pricing must keep model value, executable premium and terminal observation conceptually separate.
#Primary sources
- Oracles & Price Feeds
Official Chainlink feed semantics, multiplier treatment, pause behavior and L2 safety checks.
- Stock Token APIs
Official REST schemas for asset metadata, underlying bid/ask data and corporate actions.
- Building with Stock Tokens
Official integration guide for ERC-20 operations, ERC-8056 views, liquidity surfaces and onchain pricing.