Skip to main content

Common issues with Solana

Written by Jack

Syncing your Solana activity with Koinly is as easy as adding your public key, but if you utilized Solana's DeFi ecosystem extensively, some of your transactions may require manual adjustments. This article outlines Koinly's current support of the most popular protocols on Solana, together with any known limitations to be aware of.

🥩 Solana staking

There are two ways of handling staking on Solana:

  1. Manual with auto-compounding

    • Staking and unstaking needs to be tagged using pool labels

    • Accrued rewards need to be added manually to the pool wallet

    • Check the details in Staking and farming tokens, section Advanced scenarios > Auto-compounding pools
      ​

  2. Auto-importing rewards

    • You can toggle "Import staking rewards per epoch" to ON when setting up a Solana wallet

    • If you do, staking and unstaking transactions are skipped (not imported) and epoch rewards are automatically imported directly to your wallet, as deposits with Reward tag

🪐 Jupiter

Jupiter is the largest decentralised exchange (DEX) on the Solana blockchain, offering a wide range of trading options. When you sync your Solana wallet in Koinly, we will automatically import:

  • ✅ Trades
    All trades (swaps) done on jupiter are imported.
    ​

  • ✅ Limit orders
    Setup of a limit order (transfer of funds to the reserve wallet) is skipped and only the actual trades executed are imported to Koinly, be it full or partial fills.
    ​

  • ✅ DCA trades
    Dollar-cost-averaging trades skip the initial transfer of funds to the reserve wallet, and only import each DCA trade in your wallet.
    ​

  • ℹ️ Jupiter perps
    Koinly will import perps as deposits/withdrawals without any tags and some manual adjustments are necessary. For more information, check this post on our feedback portal:

👉 Add support for Jupiter Perps

🤿 LPing (liquidity providing)

Koinly supports all major protocols on Solana that allow you to participate in liquidity pools. For more information on how Koinly handles LPing, check our article Liquidity providing.

ℹ️ Known prices required for auto-merging

Koinly won't merge your LPing activity automatically if any of the provided tokens has a missing market price - one you add the price, the transaction should update during the recalculations

Concentrated liquidity (CLMM)

Koinly now also supports all protocols offering concentrated liquidity. In all cases, when you sync the wallet:

  • Koinly will create an additional LP token (with an orange icon)

  • This token accurately represents your share in the pool, as it shows the exact amount of liquidity units added/removed, unlike the NFT the protocol provides

  • The original NFT can be ignored/deleted

  • It's similar to how our existing support for Uniswap V3 works

CLMM protocols supported:

  1. Raydium CLMM

  2. Orca CLMM

  3. Meteora DAMM2

  4. Meteora DLMM

CLMM Limitations

There are a few known limitations to how we handle CLMM on Solana. These are mostly edge cases and should not affect many users:

  1. LP token amounts

    • Liquidity units may be pretty small and appear as 0.00 in Koinly, as the actual value is below the 12th decimal - but it's still tracked
      ​

  2. Transferring position ownership

    • If you transferred the NFT between your wallets, the LP token will not be automatically transferred as well

    • The transfer of the LP token will need to be added manually
      ​

  3. Exiting DLMM position from a particular bin range

    • If you reduced your DLMM position
      ​

  4. Position managers (like HawkFi)

    • Transactions done via managers may be incomplete or need manual adjustments

🖼️ NFTs

When you sync your wallet, all NFT transactions, including transfers, purchases and sales will be imported automatically.

NFT marketplaces

Solana's NFT marketplaces are custodial (you have to send out the NFT from your wallet to a smart contract to list it) and your transactions may need some manual adjustments. For more information, see:

👉 Interpret Tensorswap and Magic Eden NFT transactions

cNFTs (compressed NFTs)

Koinly should automatically import not only standard SPL tokens, but also NFTs from various compressed NFT protocols:

  1. Bubblegum

  2. Mpl

If your NFTs are deployed with a cNFT protocol we don't support yet and don't import to Koinly, please contact our Support team via our in-app chat.

Changelog

  • 2026-03-18
    Article was generalized to include information on other protocols on Solana, not only Jupiter. Added information about Koinly's new support for concentrated liquidity protocols

Did this answer your question?