Methodology

Nations.Fi is a nation-sector lens on Solana liquidity. You paste mint addresses into listed-token-addresses.ts under three lists — Country Coins, Event Coins, and Footballer Coins; market stats load from the DexScreener tokens API. Territory labels and globe pins are inferred from each token's name and symbol (heuristic rules), with optional per-mint ISO2 overrides in the same file when inference is wrong.

• Geography — Each row gets an ISO-3166-style alpha-2 code from name/symbol matching (or from your mint→ISO override). When a territory matches, the map pin uses a fixed country centroid; unmapped tokens use code UN and no pin.
• Markets— Price, volume, liquidity, and changes come from DexScreener's aggregated pair data (server-side fetch, ~60s cache). We pick the highest-liquidity pool per listed mint where that mint is the base token.
• Screener — Sort keys and filters mirror what traders expect (rank, MC, vol, age). Nation filters restrict rows to a single territory without hiding global context on the map.
• Listings — Token submissions pass review for metadata quality, nation-sector fit, and abuse patterns before appearing on the map.

When live data ships, this page will link to API docs, field definitions, and known limitations (e.g. wrapped assets, bridged supply).