mapin docs
Overview
mapin is a token launchpad built on a world map. Any area on the map — a country, a state or province, a city, a town, a village or a neighbourhood — can have exactly one token. The first person to launch a place creates its market and can earn creator fees on every trade.
Tokens are created and traded on BNB Smart Chain: every token starts on a bonding curve and graduates to PancakeSwap once enough of the supply has been bought. mapin never holds your funds — you sign every transaction in your own wallet.
Picking a place
Open the app and click anywhere on the map. What you pick depends on how far you are zoomed in:
- Zoomed out — the country (for example United States).
- Closer — the state, province or region (New York State).
- Closer still — the city (New York City).
- Street level — the town, borough or neighbourhood (Brooklyn).
After a click, the panel lists every area that contains that point, so you can switch between them without zooming — Brooklyn → New York City → New York → United States. The selected area is outlined on the map.
You can also search by name. Search results only include areas; streets, buildings and shops cannot be tokenized.
Launching a token
- Connect a wallet on BNB Smart Chain and sign in (a free signature, not a transaction).
- Pick a place and press Tokenize.
- Check the token name and ticker. They are filled in from the place name — several words become initials (New York City →
$NYC), a single word stays as it is ($TOKYO). You can change both. - Upload a logo (PNG, JPEG, WebP or GIF, up to 2 MB). A flag, skyline or landmark works well.
- Choose the pair (BNB or a supported stablecoin), an optional initial buy and your creator fees.
- Review and launch. mapin simulates the transaction first; if the simulation fails, nothing is sent. Your wallet then asks you to confirm.
The token's metadata points to its page on mapin, which ties the token to the place. Each place can only be launched once; if someone else is already launching the same place, you will be asked to wait a few minutes.
Creator fees
Creator fees are a percentage taken from every buy and every sell by the token contract and sent to the creator's wallet. They are optional and set once, at launch:
- Fee on buys / fee on sells — each up to 10%.
- Duration — from 30 days to permanent. After it ends, trades are fee-free.
- Anti-farming window — a short period after launch that discourages instant flipping.
- Split — by default 100% goes to the creator. You can send part of it to a burn or to liquidity instead.
Fee settings are written into the token contract and cannot be changed after launch. Every market page shows them.
Trading and graduation
New tokens trade on a bonding curve: the price rises as tokens are bought and falls as they are sold. Buy and sell directly from a place's page; every trade shows the expected amount and minimum received before you sign.
When 80% of the supply has been sold on the curve, the token graduates: its liquidity moves to a PancakeSwap pool and trading continues there. mapin keeps working the same way — the trade panel switches to the pool automatically.
Fees at a glance
| Fee | Who sets it | Where it goes |
|---|---|---|
| Trading fee | The launch contract (read live, shown before you trade) | The launch contract |
| Creator fees | The creator, at launch (0–10% per side) | Creator wallet / burn / liquidity |
| Network gas | BNB Smart Chain | Validators — shown in your wallet |
mapin itself does not add a fee on top.
Live feed
Every launch, buy and sell is read from the chain and appears in the strip at the top of every page and in the live feed on the map within seconds. Click any entry to open that place's market.
Map data
Borders and place names come from OpenStreetMap (© OpenStreetMap contributors) and are shown in English where an English name exists. Map tiles are served by OpenFreeMap. Every place on a market page links to its OpenStreetMap entry.
Safety and risks
- Tokens on mapin are community tokens. They are not issued or endorsed by any government, city or organisation.
- Prices can go to zero. Only use money you can afford to lose.
- Always check the contract address on the market page before trading.
- mapin never asks for your seed phrase or private key.
- Offensive or misleading token pages can be reported from the market page and may be hidden.
FAQ
Can two tokens exist for the same place?
No. Each place on the map can be launched once. Bigger and smaller areas are different places, so $USA and $NYC can both exist.
Can I change the name, ticker or fees after launch?
No. They are part of the token contract. Choose carefully on the review step.
Which wallets work?
Any wallet on BNB Smart Chain — browser wallets, WalletConnect, or an email login that creates a wallet for you.
My place is not on the map.
mapin uses OpenStreetMap areas. If a boundary is missing there, it can be added on openstreetmap.org and will appear on mapin after it is published.