PearlStack.netData Sources
How PearlStack chooses between indexed chain data and third-party market data.
PearlStack Chain Data
Blocks, transactions, miners, payouts, PoUW certificates, and circulating supply come from the local Pearl node and the PearlStack Postgres index. For supply, PearlStack uses indexed coinbase rewards and positive coinbase payout outputs from canonical indexed blocks.
This is why PearlStack treats PearlStack Circulating Supply as the canonical explorer value.
CoinGecko Market Data
Price, 24h volume, total supply, max supply, and FDV are fetched by the backend from CoinGecko. The browser never calls CoinGecko and never receives the API key.
CoinGecko currently reports Pearl circulating supply and market cap as 0. PearlStack keeps those fields visible only as third-party reported values, then computes explorer market cap as:
CoinGecko PRL price x PearlStack circulating supply
Caching Policy
Current market data is cached by the API for 10 minutes by default. Historical price points are cached in Postgres as a full-history set, currently 90 days, and chart windows are sliced from stored points.
A backend job can refresh market data with npm run market:refresh. This keeps page views fast and helps stay under CoinGecko rate and monthly credit limits.