Coingecko

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.

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