Model Danych

Ta strona opisuje wspólny model danych współdzielony przez narzędzia danych rynkowych Cryptohopper MCP. Trzy podstawowe typy danych — ticker, księga zleceń i świeca — mają własne strony referencyjne z dokładnym schematem odpowiedzi:

• Odniesienie do narzędzia ticker
• Odniesienie do narzędzia księgi zleceń
• Odniesienie do narzędzia świecy

Ta strona dokumentuje konwencje wspólne dla wszystkich trzech.

Konwencje

Format symbolu

Wszystkie symbole par używają formatu BASE/QUOTE:

Przykład	Podstawa	Kwotowana
BTC/USDT	BTC	USDT
ETH/USD	ETH	USD
SOL/USDC	SOL	USDC

Format jest normalizowany po stronie serwera. Giełdy źródłowe używają różnych notacji (np. BTCUSDT, BTC-USDT, tBTCUSDT); MCP prezentuje jednolity format BASE/QUOTE niezależnie od konwencji źródłowej.

Zobacz obsługiwane giełdy, aby zobaczyć listę giełd, które MCP może odpytywać.

Identyfikatory giełd

Nazwy giełd w żądaniach i odpowiedziach używają identyfikatorów pisanych małymi literami:

Identyfikator	Giełda
binance	Binance
coinbase	Coinbase
kraken	Kraken
bybit	Bybit
okx	OKX

Pełna lista jest zwracana przez narzędzie list-exchanges i udokumentowana w obsługiwanych giełdach.

Znaczniki czasu

Wszystkie znaczniki czasu w odpowiedziach są w UTC i sformatowane według ISO-8601: 2026-04-24T14:03:00Z

Numeryczne znaczniki czasu, tam gdzie są eksponowane (na przykład w rekordach świec), są znacznikami czasu Unix w milisekundach.

Kodowanie dziesiętne

Wartości cen i rozmiarów są zwracane jako liczby JSON (zmiennoprzecinkowe). Przykłady z każdego narzędzia:

// Ticker
{
  "last": 80934.19,
  "baseVolume": 11744.6152
}

// Orderbook level
[80934.18, 5.32816]

// Candle record
[1778540400000, 81833.92, 81833.92, 81720.40, 81812.55, 142.8731, 318]

Ponieważ liczby JSON są parsowane jako zmiennoprzecinkowe IEEE-754 w większości języków, klienci wymagający dokładnej precyzji (na przykład przy obliczaniu rozmiarów zleceń) powinni przekonwertować te wartości na typ dziesiętny natychmiast po parsowaniu — na przykład Decimal w Pythonie, BigNumber.js w JavaScript lub odpowiednik.

Pola opcjonalne

Niektóre pola są opcjonalne i mogą być nieobecne w odpowiedziach, gdy giełda źródłowa ich nie dostarcza. Klienci powinni traktować brakujące pola jako null, a nie jako błąd.

Wspólne pola

Trzy pola pojawiają się w większości odpowiedzi:

Pole	Typ	Opis
exchange	string	Identyfikator giełdy, z której pochodzą dane.
pair	string	Para w formacie BASE/QUOTE.
timestamp	string (ISO-8601)	Czas, w którym dane zostały przechwycone.

Pozostałe pola zależą od narzędzia. Poniżej pełne schematy.

Schemat ticker (podsumowanie)

Odpowiedź ticker to pojedynczy obiekt opisujący aktualny stan rynku. Nazwy pól są zgodne z konwencjami CCXT.

Pola obejmują:

• last — ostatnia cena transakcyjna
• bid — najlepsza cena oferty kupna
• ask — najlepsza cena oferty sprzedaży
• bidVolume — rozmiar przy najlepszej ofercie kupna
• askVolume — rozmiar przy najlepszej ofercie sprzedaży
• high — maksimum 24-godzinne
• low — minimum 24-godzinne
• open — cena otwarcia dla 24-godzinnego okna
• close — cena zamknięcia dla 24-godzinnego okna (zazwyczaj równa last)
• previousClose — cena zamknięcia poprzedniego 24-godzinnego okna
• average — średnia z open i close
• vwap — 24-godzinna średnia ważona wolumenem
• baseVolume — 24-godzinny wolumen w walucie podstawowej
• quoteVolume — 24-godzinny wolumen w walucie kwotowanej
• change — 24-godzinna bezwzględna zmiana ceny
• percentage — 24-godzinna zmiana procentowa

Zobacz odniesienie do narzędzia ticker, aby zobaczyć pełny schemat i typy pól.

Schemat księgi zleceń (podsumowanie)

Odpowiedź księgi zleceń zawiera dwie tablice — bids i asks — każdy element to krotka [cena, rozmiar]:

• bids — tablica par [cena, rozmiar], posortowana według ceny malejąco (najwyższa oferta kupna jako pierwsza)
• asks — tablica par [cena, rozmiar], posortowana według ceny rosnąco (najniższa oferta sprzedaży jako pierwsza)

Głębokość każdej strony zależy od giełdy źródłowej. Zobacz odniesienie do narzędzia księgi zleceń, aby uzyskać szczegóły.

Schemat świecy (podsumowanie)

Odpowiedź świecy to tablica rekordów OHLCV, uporządkowana chronologicznie (domyślnie najstarsze jako pierwsze). Każdy rekord to sama w sobie tablica z siedmioma pozycjami:

Indeks	Pole	Opis
0	timestamp	Czas otwarcia słupka (znacznik czasu Unix w milisekundach)
1	open	Cena otwarcia
2	high	Najwyższa cena w słupku
3	low	Najniższa cena w słupku
4	close	Cena zamknięcia
5	volume	Wolumen waluty podstawowej w słupku
6	count	Liczba transakcji w słupku

Przykład:

[1778540400000, 81833.92, 81833.92, 81720.40, 81812.55, 142.8731, 318]

Zobacz odniesienie do narzędzia świecy, aby zobaczyć pełny schemat, obsługiwane ramy czasowe i semantykę wstecznego patrzenia.

Odpowiedzi błędów

Gdy wywołanie narzędzia się nie powiedzie, odpowiedź jest zgodna z kopertą błędów MCP:

{
  "code": "QUOTA_EXCEEDED",
  "message": "Weekly call limit reached",
  "details": {
    "reset_at": "2026-04-25T00:00:00Z"
  }
}