Articles and explainers
Coingecko is a manual buy log: check portfolio P&L, then remove it
Coingecko is a manual portfolio workflow: select the correct asset and display currency, record a Buy with its quantity and execution price, inspect the resulting holdings and P&L, then log a Sell or remove the coin. The Buy changes a tracker, not a wallet balance. Use the transaction record from the venue where the purchase happened, because the saved quantity, price, and date drive the position shown afterward.
Published on
A logged Buy is not a market order
A logged Buy is an informational portfolio entry. It generates 0 blockchain transactions, moves 0 tokens, and sends no order to an exchange. Entering 0.1 Bitcoin does not affect the Bitcoin network, while recording Ethereum or Solana creates no activity on either chain.
This distinction matters at the first click. Coingecko accepts the facts of a purchase completed elsewhere and uses them to model holdings. The asset remains wherever it was held before the entry. A displayed gain is therefore a calculated change in the manual record, not sale proceeds waiting for withdrawal. Complete the real purchase first, retain its execution details, and only then reproduce those details in the portfolio.
Choose the portfolio and display currency before entry
The portfolio context determines where the new position appears and how its value is expressed. Start with 1 signed-in account, select 1 portfolio, and confirm 1 display currency before opening the transaction form. Those three choices prevent a correct Buy from landing in the wrong list or appearing in an unfamiliar unit.
The portfolio feature has 2 separate layers. A star adds an asset to a watchlist, while a transaction supplies the quantity and entry price required for holdings and P&L. USD and EUR are display currencies; switching between them does not convert Bitcoin or change the number of BTC recorded. Keep the chosen currency aligned with the execution record so the price requires no mental reconstruction.
Buy or Transfer In: match the recorded event
The transaction mode describes how the tracked holding arrived. Two modes matter at entry: Buy represents an acquisition at a known price, while Transfer In represents units received or moved into the holdings represented by the portfolio. A completed purchase belongs under Buy.
Suppose an exchange fill shows ETH acquired with USD Coin. Record the Ethereum quantity and the transaction value expressed in the selected display currency. The portfolio entry for ETH does not automatically reduce a separate USDC holding; each asset row maintains its own record. Transfer In is appropriate when the event was genuinely a receipt rather than a purchase. Choosing it merely to skip the execution price removes the cost information needed for a meaningful personal return.
Open the exact asset and enter four facts
The asset row anchors the entire transaction. Confirm the full name and ticker before entering 4 core facts: the asset, quantity, execution price, and transaction date or time. Bitcoin (BTC) and Wrapped Bitcoin (WBTC) represent different assets, even though their prices are designed to remain closely related.
- Select the exact coin page attached to the intended asset.
- Copy the acquired quantity, preserving every relevant decimal place.
- Enter the executed price per coin in the chosen display currency.
- Use the purchase date and time shown by the original transaction record.
The fill record from Coinbase, Kraken, or Binance supplies the executed amount and price. Do not substitute the price card visible when the entry is being created; that value describes another moment. Review the decimal point before saving. Entering 0.25 instead of 0.025 multiplies the modeled holding, cost, value, and absolute P&L by 10.
Confirm the position before reading P&L
The saved position should reproduce the transaction before it says anything useful about performance. Check 5 readings in order: holdings, current reference price, holding value, Total Cost, and P&L. With only 1 Buy recorded, holdings should equal the entered quantity and the average buy price should match that entry price.
The adjacent topic is explained in Coingecko api. Total Cost represents the amount recorded as spent on purchases. For a simple open position, holding value equals the tracked quantity multiplied by the current market-data price. Unrealized P&L is the difference between that value and the relevant recorded cost. Percentage P&L divides the difference by cost and multiplies the ratio by 100.
Use two independent checks before trusting the colored gain or loss. First, compare holdings with the original quantity. Second, multiply quantity by entry price and compare that number with the displayed cost. A mismatch at either step points back to the saved record. A correct cost paired with a changing P&L instead reflects movement in the market-data price used for valuation.
Worked example: one BTC buy to a 10% gain
The worked example uses entirely hypothetical, changing market inputs rather than live values. Assume a hypothetical quantity of 0.025 BTC, a hypothetical execution price of $60,000 per BTC, a hypothetical current tracker price of $66,000, and exactly 1 Buy with no Sell or transfer records.
The recorded cost is 0.025 × $60,000, which equals $1,500. The hypothetical holding value is 0.025 × $66,000, producing $1,650. Absolute unrealized P&L is therefore $1,650 − $1,500, or $150. Percentage P&L is $150 ÷ $1,500 × 100, which reaches a concrete result of 10%.
Now compare those outputs with the portfolio. Holdings should read 0.025 BTC, while the cost and value should preserve the same relationship. If holdings instead show 0.25 BTC, every dollar result becomes 10 times too large even though the percentage remains 10%. That pattern identifies a quantity error rather than an unexpected market move.
Time windows do not replace entry-based P&L
The portfolio time windows measure market movement over standard periods, not performance since a personal purchase. Coingecko offers columns such as 1-hour, 24-hour, 7-day, and 30-day percentage change. None of those four windows automatically starts at the saved Buy.
Personal P&L anchors to the transaction quantity and cost. A 24-hour market change answers how the coin moved during that window; the position return answers how the current valuation compares with the recorded entry. Read them side by side, but never interchange them. This distinction becomes especially important when the purchase occurred midway through a daily window or long before the 30-day comparison period.
Rebuild a wrong test row without doubling holdings
A wrong transaction row should be corrected before another Buy is added. A second positive entry does not replace the first one; it increases tracked holdings and compounds the original error. Recheck the asset, quantity, price, date, portfolio, and display currency against the source record.
For a disposable first-position test, the clean reset is to remove the coin, add the exact asset again, and recreate 1 correct Buy. Confirm that the holdings return from 0 to the intended quantity and repeat the cost multiplication. This short reset is easier to audit than adding compensating entries whose only purpose is to cancel a typing mistake.
A Sell record and Remove coin finish different jobs
A Sell record documents an actual disposal and reduces the tracked quantity. Remove coin clears the selected asset from the chosen portfolio list. These are 2 distinct actions, so the correct exit depends on whether the real-world position changed or the manual test record is simply no longer wanted.
The portfolio records information only; it does not hold assets, execute trades, or permit withdrawals. Complete any real sale through the wallet, exchange, or protocol holding the asset, then enter a matching Sell. Use the full disposed quantity when the actual position reached zero. If no real trade occurred and the exercise was only a test, remove the coin instead of inventing a Sell.
Remove the coin on desktop or mobile
Coin removal has a 3-step desktop path. Open the portfolio, move to the far right of the asset row and open the 3-dot menu, then choose Remove coin and confirm. That final confirmation separates navigation from the destructive portfolio change.
The mobile app provides 2 removal routes. The first mirrors desktop: open the portfolio, use the asset row's 3-dot menu, select Remove coin, and confirm. The second begins on the coin page: tap the yellow star, deselect the correct portfolio in the bottom menu, and press OK. Check the portfolio name before that 1 confirmation, especially when the same asset appears in several lists. The saved account synchronizes portfolio data across the web experience, iOS, and Android.
The workflow fits one clean manual position
The one-position portfolio workflow suits a reader who has a completed transaction record and wants a quick personal valuation. It works especially well for a first BTC, ETH, or SOL entry, a paper-position test, or a small set of purchases that remain easy to reproduce manually.
High transaction volume demands more record discipline because each missing or duplicated row changes holdings and cost. For the first exercise, keep the boundary narrow: 1 asset, 1 portfolio, 1 display currency, and 1 Buy. Confirm the position, observe how P&L responds to market data, and finish with the action that matches reality - a Sell record for a completed disposal or Remove coin for a cleared test.
What readers ask about Coingecko
-
Can I export portfolio transactions before removing a coin?
- No, Coingecko does not provide a transaction export from its website or mobile app. Preserve the original records from the exchange or wallet where each transaction occurred before clearing a portfolio entry. The portfolio is designed as a personal tracker rather than an exportable transaction ledger, so removal should never be the only place where execution details were stored.
-
Are holdings and P&L exposed when I share a public portfolio?
- Holdings and P&L are hidden by default in a shared public portfolio. The public view functions primarily as a watchlist unless those private position details are deliberately exposed through available sharing controls. Review the shared view itself after changing visibility, since the portfolio name and included assets may still be visible even when personal holding values remain concealed.
-
Will a saved portfolio synchronize across desktop, iOS, and Android?
- Yes, a saved Coingecko portfolio synchronizes across the web experience and the iOS and Android apps when the same account is used. A transaction entered on one device should therefore appear with the same portfolio record elsewhere. If an entry seems absent, first confirm the account and selected portfolio rather than creating a duplicate Buy.
-
Is the default My Portfolio deletable after a transaction test?
- The default My Portfolio is reset rather than deleted. Additional portfolios have a deletion option, while the permanent default list remains part of the account. To clear a one-coin exercise, remove that coin from My Portfolio. Deleting an entire additional portfolio is a broader action and is unnecessary when only one test position needs to disappear.
-
Can I keep a paper transaction separate from real holdings?
- Yes, create a separate portfolio and place the simulated Buy there. Multiple portfolios keep test entries apart from manually recorded holdings while using the same market-data valuation. Give the paper portfolio an unmistakable name, select it before adding the asset, and confirm its name again before removing the test. No simulated entry changes a real wallet or exchange balance.
-
Does one coin belong in more than one portfolio at the same time?
- Yes, the same coin may be selected for multiple portfolios. Each list provides a separate organizational context, so Bitcoin could appear in both a watchlist and a manual position portfolio. When adding or removing it through the star menu, inspect every selected portfolio before pressing OK. Removing it from one list should not be treated as a request to clear every list.
-
Why does Total Cost remain unchanged after I add a Sell?
- Total Cost represents the overall amount recorded as spent on Buy transactions, not the net amount still invested after sales. A Sell therefore does not reduce that field. For a net-cost view, multiply Average Net Cost by current Holdings. Keep this accounting distinction separate from holding value and P&L, which respond to the remaining quantity and market-data price.
-
Are current portfolio valuations taken from the exchange where I bought?
- No, the current portfolio valuation uses Coingecko market data rather than the exact live price on the purchasing venue. Your manual Buy should still use the execution price from that venue's completed transaction record. This creates two intentional inputs: the personal entry price records what happened, while the market-data reference estimates what the tracked quantity is worth now.