Skip to main content
A market registry is an optional account that lists every Shard Book one operator runs for a single trading pair. It stores:
  • admin, the only key allowed to add or remove entries
  • base_mint and quote_mint, the pair every listed market must share
  • markets, up to 64 addresses of that operator’s Shard Books for the pair

Why it exists

The matching engine never reads a registry. A taker can fill against any Shard Book whose accounts they supply, whether or not that book is listed in a registry anywhere. The registry exists purely for discovery: it gives indexers, aggregators, and front ends a single on-chain place to find out which Shard Books an operator wants to be found at for a given pair, instead of each one keeping its own separate off-chain list that has to be told by hand every time the operator adds or removes a market. Because it is a regular account like any other, anything watching it can subscribe and learn the moment the set of markets changes, rather than polling for updates.