Kaspa KRC-20 guide · Toccata era

How to add & see a
KRC-20 token in your wallet

Just minted or bought a token and it's not showing up? Here's the reassuring truth: KRC-20 tokens aren't imported by contract address — they're read from the on-chain indexer and appear automatically in a KRC-20-aware wallet. Your keys hold the tokens either way.

The 30-second version

You don't "import" a KRC-20 — the wallet reads it

If you're coming from Ethereum, you're used to pasting a contract address to add a token. KRC-20 doesn't work that way. KRC-20 is an indexer-based standard: there's no per-token contract to import. The Kasplex indexer tracks every token's ticker and every address's balance, and your wallet simply queries it and lists what your address holds.

So the real question isn't "how do I add the token" — it's "is my wallet reading KRC-20 at all, and is it looking at the right address?" A KRC-20-aware wallet like KasWare or Kastle shows your tokens the moment you open the tokens tab. A KAS-only wallet holds your KAS fine but won't display token balances — and that's the single most common reason a token "disappears."

The important part: your tokens live on-chain, tied to your keys — not inside the wallet app. Whether or not a given app draws them on screen, they're yours. That's what non-custodial means, and it's why a missing token is almost never a lost token.

Step by step

Seeing your KRC-20 tokens

Four steps from "where did my token go?" to seeing, and sending, your balance with confidence.

1

Use a KRC-20-aware, non-custodial wallet

KRC-20 balances only appear in a wallet that reads the KRC-20 indexer — for example KasWare or Kastle. A KAS-only wallet will hold and send your KAS but won't show token balances. If yours doesn't, your tokens aren't gone: restore your seed phrase into a KRC-20-aware wallet and they'll appear. The best wallet guide compares the options.

Never paste your seed into a website to "unlock" a token. A real wallet never needs it, and nobody legitimate will ask.

2

Open the KRC-20 / tokens tab — no contract address needed

Unlike an ERC-20, you don't paste a contract address to import a KRC-20 token. The wallet asks the Kasplex indexer for every balance held by your address and lists them for you. Open the tokens or KRC-20 tab and your holdings are simply there — identified by ticker, not by a contract.

3

Don't see a token you just got? Check three things

A missing token is almost never lost. Run down the list:

Same wallet and address? Make sure you're viewing the exact receiving address you minted or bought to. ② Give the indexer a minute. Right after a fresh mint or transfer, the indexer can take a short while to reflect the new balance. ③ Verify on an explorer. Look your address up on a public Kaspa explorer — if the balance shows there, your tokens are safe and it's just the wallet display catching up (or the wrong wallet from step 1).

4

Send or manage a KRC-20 token

Sending a KRC-20 is a transfer operation you submit from your own wallet, paid for with a small amount of KAS as the network fee — so always keep a little KAS in the account for gas. Pick the token, paste the recipient's Kaspa address, double-check it, and sign.

You keep custody the entire time — nothing else moves your funds. On-chain transfers can't be reversed, so verify the address before you confirm.

Your keys hold the tokens — keep it that way

The reason a "missing" KRC-20 is almost always safe is the same reason non-custodial matters: your tokens live on-chain under your keys, not inside an app or a bot's account. So when it's time to get into a launch, mint the same way — from your own wallet. Minting through the Fair-Launch Radar is a flat 1.75%, non-custodial, vs the 5% the dominant bots take.

1.75%vs 5% on the bots
Questions people search

Adding & seeing a KRC-20 token — FAQ

How do I add a KRC-20 token to my wallet?

You don't manually add or import one the way you would an ERC-20. KRC-20 balances are read from the on-chain Kasplex indexer against your address, so a KRC-20-aware wallet like KasWare or Kastle detects and shows them automatically — just open the tokens tab. If a token isn't there, you're usually on a KAS-only wallet, a different address, or the indexer hasn't synced yet.

Do I need a contract address to add a KRC-20 token?

No. Unlike ERC-20 tokens on Ethereum, KRC-20 tokens have no per-token contract address to paste in. KRC-20 is indexer-based: the ticker and every address's balance are tracked by Kasplex, and your wallet queries it directly. You identify a token by its ticker, not a contract. More on how the standard works in the what is KRC-20 guide.

I minted or bought a token but it's not showing. Is it lost?

Almost certainly not. KRC-20 tokens live on-chain, tied to your address and keys — the wallet only reads and displays them. Check three things: you're on the same wallet and address you used, the indexer has had a few minutes to catch up, and the balance on a public explorer. If the explorer shows it, your tokens are safe and the display just needs to sync — or you need a KRC-20-aware wallet.

Which wallets show KRC-20 token balances?

Non-custodial wallets that read the KRC-20 indexer — KasWare and Kastle — display balances automatically. A KAS-only wallet holds and sends KAS but won't show tokens. If your wallet doesn't support KRC-20, restore your seed into one that does and your tokens appear. See the best Kaspa wallet guide.

How do I send a KRC-20 token?

In a KRC-20-aware wallet, open the token, choose send, enter the recipient's Kaspa address, and sign the transfer from your own wallet. A transfer is paid with a small amount of KAS as the network fee, so keep a little KAS in the account. Double-check the address first — on-chain transfers can't be reversed. Selling instead? See how to sell a KRC-20.

Does adding or holding a KRC-20 token cost anything?

Seeing a token in your wallet is free — the wallet just reads the indexer. You only pay a small amount of KAS as a network fee when you send a token or mint one. There's no charge to view a balance and no subscription to hold KRC-20 tokens.

Live now

Got your wallet sorted? Find a fair launch

Now that you can see and send your tokens, check any launch's fairness on the radar first — then mint the fair ones the cheap way: from your own wallet, at a flat 1.75%.