How to Add Custom Tokens to OKX Wallet? Step-by-Step Guide

Accessing the Token Management Interface

1. Open the OKX Wallet application on your mobile device or browser extension.

2. Navigate to the “Assets” tab located at the bottom navigation bar.

3. Tap the “+” icon in the top-right corner of the asset list screen.

4. Select “Add Token” from the dropdown menu to enter the custom token configuration panel.

5. Confirm that you are operating on the correct blockchain network before proceeding—OKX Wallet supports Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, and X Layer.

Entering Contract Address and Network Details

1. Manually input the full contract address of the token you wish to add—this must be a verified, non-malicious address deployed on a supported chain.

2. Ensure the contract address matches the selected network; for example, an ERC-20 token on Ethereum must use an Ethereum-based address, not a BSC one.

3. The wallet will automatically attempt to fetch token metadata—including name, symbol, and decimals—if the contract is standard-compliant and publicly verified.

4. If metadata fails to load, manually enter the token symbol (e.g., “PEPE”), name (e.g., “Pepe”), and decimal places (commonly 18 for most ERC-20 tokens).

5. Double-check all fields for accuracy—any typo in the contract address may result in irreversible loss of funds when sending or receiving.

Verifying Token Standards and Compatibility

1. OKX Wallet only recognizes tokens adhering to widely adopted standards: ERC-20, BEP-20, and ERC-721 for NFTs.

2. Tokens built on non-standard or experimental implementations—such as custom transfer logic or unverified proxy contracts—will not appear in the asset list even after successful addition.

3. Cross-chain wrapped tokens (e.g., wBTC on Ethereum) are supported if their underlying contract is verified and conforms to the expected interface.

4. Tokens deployed on unsupported chains—like Solana SPL tokens or Cardano native assets—cannot be added via this method and remain invisible in the interface.

5. No automatic token discovery occurs across block explorers or decentralized indexes; users must provide precise contract details without relying on fuzzy search or partial address matching.

Finalizing and Displaying the Token

1. After entering all required fields, tap “Next” to initiate validation.

2. The wallet verifies contract existence, bytecode integrity, and interface compliance on-chain in real time.

3. Upon successful verification, the token appears under “Custom Tokens” within the Assets tab.

4. You may rename the token locally—for display purposes only—but this change does not alter on-chain identifiers or affect transaction routing.

5. The token balance reflects only on-chain holdings; it does not sync with exchange accounts, staking positions, or off-chain balances held by third-party services.

Frequently Asked Questions

Q1: Can I add a token with an unverified contract address?Yes, but OKX Wallet will not display its balance or allow interaction unless the contract passes on-chain bytecode and interface checks. Unverified contracts often fail validation silently.

Q2: Why does my custom token show zero balance even though I hold it on-chain?This occurs when the wallet fails to detect transfer events due to non-standard event emission, missing decimals field in the contract, or incorrect network selection during setup.

Q3: Is it safe to add tokens from unknown sources using this method?No. Adding a malicious contract may expose your wallet to approval exploits or front-running attacks. Always verify contract source code on Etherscan or equivalent block explorer before adding.

Q4: Do custom tokens support swap functionality inside OKX Wallet’s DEX interface?Only if the token has sufficient liquidity on integrated DEX aggregators like 1inch or Uniswap and its pair exists on the same chain. No manual liquidity provisioning is possible through the wallet UI.