master.feed
- Version
- 0.1.0
- Desk
- Terms named on this page
Which price feed belongs to which token, and what the feed answered.
Changelog
| Version | Date | Change |
|---|---|---|
0.1.0 | 2026-11-11 | First version. |
What it measures
For each Robinhood token, the Chainlink feed that prices it, and on each check of that token the feed's latest answer and its time (feed_price, feed_updated_at). It does not measure whether the price is right, and it does not price a token that has no feed.
Inputs
- Chainlink's feed directory for Robinhood Chain, the JSON file shown on
https://docs.chain.link/data-feeds/price-feeds/addresses?network=robinhood. Its URL is inpackages/master/data/sources.json. Read daily bymaster.feeds-sync. On 2026-11-10 it held 62 entries: 35 visible equity and ETF feeds markedus_equities_24/5, 4 hidden 24/7 variants, and 23 crypto feeds. - On chain, when the directory or the registry changed: the feed's
decimals()anddescription(),getFlag(feed)on Chainlink's Flags contract (0xbb601d8e5e568e6464d6d34fee489aa61b8d035a), and the token's ownsymbol(), all at one block. - On each check of a token with a feed:
latestRoundData()on the feed, at one block.
The rule
- Only visible entries with market hours
us_equities_24/5are read. Hidden entries are skipped. - An entry names its stock in its name,
Robinhood TSLA / USDorRobinhood SGOV-USD; the ticker is the part afterRobinhood. - A feed belongs to one token: the Robinhood token whose
symbolKey(symbol())equals the feed's ticker. These are Robinhood's feeds: Chainlink's page for them,https://docs.chain.link/data-feeds/tokenized-equity-feeds/robinhood.mdas read on 2026-11-10, gives the token's price as the underlying price times that token's ownuiMultiplier(). Given to an Ondo token of the same stock, the price would be off by the difference between the two issuers' multipliers, so an Ondo token gets no feed unless the directory names one for it. - The feed is assigned only when, on chain, its
decimals()equals the directory's, it answersdescription(), the Flags contract lists it, and the token's ownsymbol()has the feed's ticker as its key. On-chain descriptions differ from the directory's names (RHTSLA / USD), so a feed is matched by its address, never by its description. - A feed whose ticker matches no Robinhood token, or more than one, is ignored and counted in the job's state.
The standard proxy of each feed is used, not its second proxy.
A token's feed and the list it came from are written together. A run writes the feed of every token that changed, and the job's state master.feeds, which names the list by its SHA-256, in one batch of one step. feed_price cites the list that state names as the one that gives the feed's decimals, so at no moment does a token hold a feed from another list than the one its figure cites. A run that fails writes neither.
Thresholds
| Threshold | Default | Where |
|---|---|---|
Market hours read | us_equities_24/5 | FEED_RULES.marketHours |
The feed list is stale after | 259,200 seconds (3 days) | FRESHNESS.feedListSeconds |
Terms
None. The market state that uses the feed is master.market-state.
Evidence
feed_price: the calllatestRoundData()on the feed at the block of the check, and the feed list (URL, fetch time, SHA-256) that gives the feed's decimals. The price is the answer divided by 10^decimals, in US dollars per token.feed_updated_at: the calllatestRoundData()on the feed at the block of the check. The time is the round's own.
Recomputation
pnpm tool packages/master/recompute.ts --envelope answer.json --rpc <endpoint> calls latestRoundData() again and compares the answer and its time. No free endpoint serves past state, so without an archive endpoint the script re-reads at the head block and says so; a feed that updated since then shows as a mismatch, which is what happened.
Ways to game it, and what the method does
| Way | What the method does |
|---|---|
A token named like a stock that has a feed | Feeds go only to Robinhood tokens stored from the registry; any other address has no feed here. |
A directory entry pointing at a contract that is not a Chainlink feed | It must be listed by Chainlink's Flags contract and answer the directory's decimals. |
A Stock Token whose symbol was changed | Its live symbol() must still have the feed's ticker as its key. |
Limits
- 35 feeds for 218 listed tokens, on 2026-11-10: most tokens have no feed, and
No feedis the common market state. - The directory is read once a day. A feed added or removed in between is seen the next day. A token first listed in between has no feed until then, and its market state reads
No feedfor that time. - A list that would change the feed of more than 880 tokens at once is not applied: the run fails with that reason and changes nothing, because its rows could not be written in one batch with the state.
- A feed's price is what the feed answered. This method reports the answer as read and does not judge it.
What overlaps elsewhere
Chainlink's directory lists the feeds. This method adds the on-chain confirmation and the rule that a feed belongs to one issuer's token.