CoinsCountriesLiveDocsSearch

How PairCountry works

A coin's pair is its country. The country token is ETH one-to-one. Every coin stands alone, every fee goes to its creator.

Country tokens

PairCountry registers 201 countries on Robinhood Chain, each with a fixed name and ticker (the United States is USA, Japan is JAPAN, Brazil is BRAZIL). The first coin launched under a flag deploys that country's token. A country token is wrapped ETH: one USA is always one ETH, anyone can wrap and unwrap, nobody owns it, nothing can mint it except a deposit.

Because the quote is pegged to ETH, the ten coins under the same flag do not move each other. The country is the pair and the flag on the coin, never a price of its own. The leaderboard ranks countries by what their coins trade.

Coins: two locked pools

A launch mints one billion coins and opens two Uniswap v4 pools, half of the supply in each, both at the same opening price (0.6 ETH behind the whole supply), both single-sided positions owned by the PairCountry contract with no function that can remove them:

  • COIN / COUNTRY — the pair everyone sees. The coin's address is mined so it is always currency0: on every explorer the pair reads TICKER / USA.
  • COIN / ETH — native ETH, so DexScreener and every wallet or aggregator price and route the coin from second one.

The site's router splits every buy and sell 50/50 across the two pools, so its own trades never push them apart; anyone else can trade either pool directly, and arbitrage keeps them equal.

Fees

Pool fee, per trade, both pools1%
→ the coin's creator, paid in ETH1%
Launch fee0.0005 ETH

Fees sit in the pools until someone calls harvest(coin). Anyone can, and the site does it hourly. The harvest pokes both positions, sells the coin-side fees inside their own pool, unwraps the country token and pays the creator in ETH. If a payout cannot be delivered the ETH is parked in the contract for the creator to withdraw. Coin fees that cannot sell yet (a pool at the bottom of its curve) wait for the next harvest; nothing is lost and nothing can be taken by PairCountry.

What the owner can and cannot do

  • Can: set the launch fee, the opening market cap of future coins, an optional anti-snipe surcharge for the first seconds of a new coin, pause new launches, withdraw launch fees.
  • Cannot: touch any pool, any liquidity, any trade fee, any parked payout, or change the fee. Those are constants in the contract.
  • The contracts are not upgradeable. Ownership is meant for a hardware wallet with two-step transfer.

Contracts

  • PairCountry countries, launches, the two locked pools per coin, harvest0x0F32…bB9F
  • CountryRouter the site's trading path: ETH in, coin out, split across both pools0x3F79…d780
  • FeeHook Uniswap v4 hook: 1% fee, PairCountry-only liquidity0xBFef…6880
  • TokenFactory mints country tokens and coins with ordered addresses0xF94A…8ec1
  • Uniswap v4 PoolManager official Uniswap deployment — every pool lives here0x8366…0951

Public API

Read-only JSON, no key, rate-limited per IP, CORS open. Base URL https://paircountry.com/api/v1.

  • GET /countries?sort=volume|total|coins|creators|newest&open=1 every registered country with live numbers for the ones that have coins
  • GET /countries/{iso2} one country, its coins and recent trades
  • GET /coins?sort=trending|newest|biggest|oldest&country=US&q=&limit=&offset= coins
  • GET /coins/{address} one coin with trades, price points and harvests
  • GET /feed?limit= latest trades across all flags
  • GET /stats site totals

Risk

Coins are memecoins. They have no rights, no backing and no relation to any government; flags are symbols. Prices are set only by trading in locked pools and can go to zero. Read the terms.