Metodologia Obliczania Cen

1. Źródła Danych

1.1 Integracja z giełdami

CoinPaprika integruje się z giełdami kryptowalut za pośrednictwem ich publicznych API. Każda giełda musi dostarczać identyfikatory par rynkowych (np. BTC/USD, ETH/BTC), ostatnią cenę transakcji dla każdej pary rynkowej oraz 24-godzinny wolumen obrotu dla każdej pary rynkowej.

1.2 Zakres

W pipeline obliczania cen uwzględniane są wyłącznie rynki spot. Rynki instrumentów pochodnych (kontrakty terminowe, swapy perpetualne, opcje) są wyłączone, ponieważ ich ceny mogą znacznie odbiegać od bazowej ceny spot ze względu na stopy finansowania, mechanikę wygasania i dynamikę dźwigni finansowej.

1.3 Zewnętrzne dane referencyjne

Kursy walut fiat są pozyskiwane z Open Exchange Rates w celu przeliczania między walutami fiducjarnymi (EUR, GBP, JPY itp.) a USD. Kursy powiązania stablecoinów — USDT, USDC i innych głównych stablecoinów — są przeliczane na USD przy użyciu indeksu ważonego wolumenem, opartego na ich rynkach wejścia w USD.

2. Pipeline Obliczania Cen

Algorytm jest zaprojektowany do obliczania cen wyłącznie na podstawie bieżącego stanu rynku, bez żadnej zależności od cen z poprzednich uruchomień. Każde wykonanie zaczyna od zera, inicjując własne kursy przeliczeniowe z danych rynkowych w czasie rzeczywistym i osiągając dokładne ceny poprzez wielokrotne iteracje. Cały pipeline uruchamia się co 60 sekund.

1. Zbieranie danych

   Z każdej zintegrowanej giełdy CoinPaprika pobiera wszystkie dostępne rynki spot. Każdy rynek dostarcza: nazwę pary rynkowej (np. BTC/USD), ostatnią cenę transakcji w walucie kwotowania oraz 24-godzinny wolumen obrotu w walucie kwotowania.

2. Ustalenie kursu referencyjnego BTC/USD

   Algorytm zaczyna z zerowo przyjętymi cenami. Pierwszym obliczeniem jest ważona średnia cena BTC/USD, wyznaczana bezpośrednio ze wszystkich rynków spot BTC/USD. Bitcoin jest wybierany, ponieważ rynki BTC są zazwyczaj najbardziej płynne na wszystkich giełdach.

   BTC_USD = Σ(Price_i × Volume_i) / Σ(Volume_i)
   where i = each BTC/USD market across all exchanges

3. Pierwsza runda: Wyłącznie rynki BTC i fiat

   Używając kursu BTC/USD, algorytm przetwarza rynki, gdzie jedna strona pary to BTC lub waluta fiducjarna. Rynki denominowane w BTC (np. ETH/BTC, SOL/BTC):

   Price_USD = Price_BTC × BTC_USD

   Rynki denominowane w fiat (np. ETH/EUR, BTC/JPY):

   Price_BTC = Price_USD / BTC_USD

4. Kolejne rundy: Uwzględnienie wszystkich rynków

   Wiele kryptowalut jest również handlowanych w parach z innymi kryptowalutami. Algorytm używa kursów przeliczeniowych z poprzedniej rundy, aby iteracyjnie rozwiązywać te rynki.

   Pass 1: BTC/USD markets → BTC_USD rate
   Pass 2: BTC + fiat markets → conversion rates for major coins
   Pass 3: All markets using Pass 2 rates → refined rates, more coins covered
   Pass N: Repeat until convergence → all reachable coins have prices

5. Wykrywanie i usuwanie wartości odstających

   Przed finalną agregacją anomalne ceny rynkowe są identyfikowane i wykluczane. Rynki wykluczane z góry obejmują te z zerową prowizją handlową, zachętami do transaction mining, przestarzałymi danymi (>30 min) oraz parami na czarnej liście. Statystyczne wykrywanie wartości odstających używa granic opartych na medianie, dostosowanych do głębokości płynności.

   The statistical stages are described in Section 3.

6. Cena końcowa: Średnia ważona wolumenem

   Po usunięciu wartości odstających cena końcowa jest średnią ważoną wolumenem wszystkich pozostałych prawidłowych rynków:

   Price_USD = Σ(Price_i_USD × Volume_i_USD) / Σ(Volume_i_USD)

   Rynki o wyższej płynności naturalnie mają większą wagę, zapewniając, że zagregowana cena odzwierciedla miejsce, gdzie odbywa się większość rzeczywistej aktywności handlowej.

3. Outlier Detection

Outlier removal runs as four independent stages before any price is averaged. Each catches a failure the others cannot see.

3.1 Stage 1 — Excluded Markets

Markets on exchanges under verification, and markets manually excluded after review, are dropped before anything is measured.

3.2 Stage 2 — Volume Anomalies

Volume is checked before price, because a fabricated volume corrupts every weight downstream. Markets reporting negative or implausibly large volume are rejected outright.

Past that bound, an asset's markets are accumulated smallest-first, and a market is rejected only when it fails several independent tests at once: the accumulated total must exceed a floor, the market's volume must be out of proportion to the smaller markets already accumulated, and the new total must exceed both the asset's previous observed maximum and its 24-hour median by a multiplier. Requiring all of them together is what keeps a genuine new listing on a large venue from being mistaken for fabricated volume. The limits scale with the asset's own median volume: the more liquid the asset, the tighter the constraint.

A rejection here is not final. Flagged markets are surfaced for review, and a market confirmed as genuine is re-admitted to the calculation.

3.3 Stage 3 — Trusted Price Band

Rather than applying one statistical test to every asset, CoinPaprika derives a trusted price band per asset per run, using the strongest method the available market depth supports and falling back through five tiers:

1. Interquartile. Requires several markets above a volume floor. Qualification is decided on the asset's stronger markets, but the band itself is computed across all but its emptiest ones. The band widens with the asset's own dispersion, so a volatile asset is not punished for being volatile.
2. Median bound, narrow. Requires several markets above a lower floor, with more than half of all markets already clustered around the median. The band is then tightened to the lowest and highest price actually observed.
3. Median bound, wide. As above, with fewer markets required and a wider tolerance.
4. Reference price. No usable market cohort, but a previous reference price exists. The band's width scales with the asset's median volume.
5. Last observed price. No reference price either, but a recent observation exists.

A liquid asset with many honest markets gets a tight band. A thin asset gets a wide band rather than a wrong one.

Stablecoins are treated as a separate class. The volume threshold for the strongest tier is lowered, so that tier stays available for assets whose individual markets are smaller, and the dispersion factor is tightened. An asset that should sit at its peg is given a far narrower tolerance than a volatile one.

Prices outside an asset's band never enter its average. Markets inside the band face one more check: a market — or a group of markets sitting on the same side of the median — whose distance-weighted volume would pull the average materially away from the median is excluded as well. And if every market for an asset lands outside its band, the markets are rejected rather than the band: the asset keeps its previous price instead of adopting a suspect one.

For thinly-listed assets, absolute sanity checks run alongside the band: a price or volume implausible on its face, or an implied market capitalization exceeding Bitcoin's, is rejected regardless of what the band would allow.

3.4 Stage 4 — Exchange-Level Anomalies

A final pass aggregates volume per exchange and compares it against that venue's own recent history — its previous maximum and its 24-hour median. The comparison is made only when the venue's market list is unchanged: a volume jump explained by newly added markets is not an anomaly, but the same jump on an unchanged market set is. This catches a venue-wide distortion that each individual market would survive.

3.5 Why a Band Is Derived for Every Asset

Assets are priced through one another, so one bad market propagates. An asset quoted at $1 on a single small market, joined by a second market of similar size quoting the inverse pair at $1,000, would carry that asset's reference price from $1 to roughly $500 on the next run — and from there into every asset quoted against it, and onward through the graph. Deriving a band for every asset, including those with too little data to measure precisely, breaks that chain at the first link.

4. Obliczanie Wolumenu Obrotu

4.1 Wolumen na giełdę

24-godzinny wolumen obrotu dla każdej giełdy to suma wolumenów przeliczonych na USD we wszystkich jej aktywnych parach handlowych nienajdujących się na czarnej liście. Pary, które nie były aktualizowane przez 30 minut, są wyłączone.

Exchange_Volume = Σ(Volume_pair_i × Price_pair_i_USD)

4.2 Wolumen na aktywo

24-godzinny wolumen obrotu dla indywidualnego aktywa to suma wolumenów we wszystkich prawidłowych parach rynkowych na wszystkich zintegrowanych giełdach.

4.3 Wolumen globalny

Globalny wolumen obrotu kryptowalutami to suma wszystkich wolumenów poszczególnych giełd.

5. Wynik Zaufania Giełdy

Każda giełda otrzymuje Wynik Zaufania w skali 0–100, odzwierciedlający niezawodność i jakość raportowanych przez nią danych. Wynik Zaufania wpływa na sposób ważenia i filtrowania danych giełdy w pipeline obliczania cen.

5.1 Kryteria oceny

5.2 Zastosowanie Wyniku Zaufania

• Giełdy objęte przeglądem są całkowicie wykluczone z obliczeń cen i wolumenów.
• Wyniki Zaufania są regularnie przeglądane i aktualizowane oraz mogą ulec natychmiastowej zmianie w odpowiedzi na istotne zdarzenia (włamania, działania regulacyjne, przedłużone awarie API itp.).
• Dane giełd podlegają dodatkowemu badaniu za pośrednictwem Wskaźnika Płynności Par Rynkowych (zob. Sekcja 6).

5.3 Szacowany Rzeczywisty Wolumen (ERV)

Szacowany Rzeczywisty Wolumen to miara wprowadzona w 2019 roku w celu zwalczania fałszywego wolumenu i wash tradingu. ERV jest wyprowadzany ze Wskaźników Płynności wszystkich rynków danej giełdy. Raportowany 24-godzinny wolumen każdego rynku jest korygowany przy użyciu wag przypisanych do jego kategorii wskaźnika płynności (Dobra, Przeciętna lub Zła).

6. Wskaźnik Płynności Par Rynkowych (Kropki)

Poszczególne pary rynkowe otrzymują w czasie rzeczywistym ocenę płynności opartą na spreadzie arkusza zleceń (procentowa różnica między najlepszą ofertą kupna a sprzedaży), głębokości arkusza zleceń (wartość w granicach ±1% i ±10% ceny środkowej), spójności wolumenu oraz weryfikacjach wartości odstających.

6.1 Kategorie wskaźnika

• Dobra — Silna płynność i normalne warunki rynkowe.
• Przeciętna — Ograniczone lub zmienne warunki rynkowe; płynność jest niższa niż sugeruje raportowany wolumen.
• Zła — Niewystarczająca płynność w stosunku do raportowanego wolumenu lub poważnie niezrównoważone warunki rynkowe.

Pary rynkowe, które nie przechodzą kontroli płynności, są przycinane w obliczeniu VWAP. Jeśli nie istnieje inne źródło do obliczenia ceny i wolumenu aktywa, para jest nadal używana — z wyraźnym wskazaniem, że płynności nie udało się zweryfikować.

7. Podaż w Obiegu

7.1 Monety Proof-of-Work

W przypadku kryptowalut opartych na PoW (np. Bitcoin, Litecoin) podaż w obiegu jest pobierana bezpośrednio z API eksploratorów bloków. Wartości są weryfikowane w oparciu o kilka niezależnych eksploratorów bloków i automatycznie aktualizowane wraz z wydobyciem nowych bloków.

7.2 Tokeny (oparte na inteligentnych kontraktach)

Dla tokenów ERC-20 i podobnych podaż w obiegu obliczana jest jako:

Circulating Supply = Total Supply - Locked Tokens

Locked Tokens includes:
  - Team/founder vesting wallets
  - Treasury or reserve wallets
  - Burn addresses
  - Locked staking contracts

7.3 Weryfikacja

Dane dotyczące podaży w obiegu są porównywane z informacjami ujawnionymi przez zespoły projektów i aktualizowane gdy zachodzą zdarzenia odblokowania, spalania tokenów lub inne zdarzenia wpływające na podaż. Konkretne progi są celowo utajniane, aby zapobiec manipulacjom.

8. Wskaźniki Pochodne

8.1 Kapitalizacja Rynkowa

Per-asset:  Market Cap = Current Price (USD) × Circulating Supply
Global:     Global Market Cap = Σ(Market Cap of all tracked assets)

8.2 Historyczne Maksimum (ATH)

Dla każdego aktywa CoinPaprika śledzi najwyższą kiedykolwiek odnotowaną zagregowaną cenę, datę jej wystąpienia oraz bieżący dystans od ATH:

ATH Distance (%) = (ATH Price − Current Price) / ATH Price × 100%

9. Kryteria Listowania

9.1 Aktywa Kryptowalutowe

Aby zostać wymienioną na CoinPaprika, kryptowaluta musi spełniać następujące wymagania:

• Działająca strona internetowa należąca do projektu z wyraźnymi informacjami o projekcie
• Działający eksplorator bloków z weryfikowalnymi danymi on-chain
• Aktywny handel na co najmniej jednej giełdzie zintegrowanej z CoinPaprika
• Przejrzysta komunikacja — projekt utrzymuje publiczne kanały (X/Twitter, Telegram, Discord) z terminowymi aktualizacjami i responsywnością na problemy społeczności

9.2 Giełdy

Aby zostać zintegrowaną jako źródło danych, giełda musi:

• Prowadzić działającą stronę internetową z weryfikowalną aktywnością handlową
• Udostępniać publiczne REST API spełniające standardy danych CoinPaprika (pary rynkowe, ceny, wolumeny)
• Utrzymywać aktualną dokumentację API
• Zapewniać dedykowany punkt kontaktowy dla kwestii jakości danych

10. Asset Identifiers

Reference data is only usable inside a regulated workflow if it joins to the identifiers that workflow already runs on. CoinPaprika maps its asset IDs to external identifiers:

• DTI — Digital Token Identifier (ISO 24165), issued by the Digital Token Identifier Foundation. The ISO standard identifier for digital tokens, and the identifier regulatory reporting regimes reference for digital assets.
• ISIN — International Securities Identification Number (ISO 6166), which joins crypto positions to instrument records in existing back-office, custody and accounting systems.
• Provider IDs from CoinMarketCap, CoinGecko and CryptoCompare, for reconciliation and migration without re-mapping a universe by hand.

Mappings are available through the API ID Mappings endpoint: docs.coinpaprika.com — API ID Mappings

11. Independence and Conflicts of Interest

CoinPaprika is independently owned. It is not owned by, and holds no stake in, any cryptocurrency exchange, trading venue, market maker or token issuer. This distinguishes CoinPaprika from aggregators owned by the venues whose data they publish.

11.1 What a Commercial Relationship Can and Cannot Affect

CoinPaprika operates a paid expedited listing service (Fast Track) and carries advertising. Both are disclosed here, because a claim of independence is only useful if it is specific about its limits.

Fast Track buys moderator time: a submission and its metadata are reviewed and processed on a priority schedule instead of the standard queue. It buys nothing else.

No payment of any kind affects:

• the price calculated for an asset, which is produced by the pipeline described on this page and subject to the same outlier detection as every other listed asset;
• an exchange's Confidence Score;
• a market pair's Liquidity Indicator;
• ranking, which is derived from calculated market capitalization.

Listing is a decision about coverage. Pricing is a measurement. An asset admitted through Fast Track is measured by exactly the same method as any other: a thin asset receives a correspondingly wide trusted band and a low liquidity indicator.

Advertising is labeled as advertising and is never presented as data.

Questions about this methodology, including any concern about a potential conflict of interest, can be raised through our contact page: coinpaprika.com/contact

12. Częstotliwość Aktualizacji