Metodologia Obliczania Cen

1. Źródła Danych

2.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.

2.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.

2.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.

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. 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.

4. 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 5).

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).

5. 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ć.

6. 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.

7. 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%

8. 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

9. Częstotliwość Aktualizacji