FACTA

master.feed

Version
0.1.0
Terms named on this page

Which price feed belongs to which token, and what the feed answered.

Changelog

Changelog
VersionDateChange
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 in packages/master/data/sources.json. Read daily by master.feeds-sync. On 2026-11-10 it held 62 entries: 35 visible equity and ETF feeds marked us_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() and description(), getFlag(feed) on Chainlink's Flags contract (0xbb601d8e5e568e6464d6d34fee489aa61b8d035a), and the token's own symbol(), all at one block.
  • On each check of a token with a feed: latestRoundData() on the feed, at one block.

The rule

  1. Only visible entries with market hours us_equities_24/5 are read. Hidden entries are skipped.
  2. An entry names its stock in its name, Robinhood TSLA / USD or Robinhood SGOV-USD; the ticker is the part after Robinhood.
  3. 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.md as read on 2026-11-10, gives the token's price as the underlying price times that token's own uiMultiplier(). 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.
  4. The feed is assigned only when, on chain, its decimals() equals the directory's, it answers description(), the Flags contract lists it, and the token's own symbol() 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.
  5. 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

Thresholds
ThresholdDefaultWhere
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 call latestRoundData() 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 call latestRoundData() 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

Ways to game it, and what the method does
WayWhat 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 feed is 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 feed for 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.