Narzędzie referencyjne dla tickera

Ta strona jest narzędziem referencyjnym do pobierania zrzutów tickera z Cryptohopper Market Data MCP.

Nazwa narzędzia

get_ticker

Cel

Zwraca podsumowanie stanu rynku w danym momencie dla określonej pary na określonej giełdzie. Zawiera ostatnią cenę transakcji, najlepszą ofertę kupna i sprzedaży, zakres 24-godzinny, wolumen 24-godzinny i zmianę 24-godzinną.

Argumenty

Argument	Typ	Wymagane	Opis
exchange	string	Tak	Identyfikator giełdy (małe litery).
pair	string	Tak	Para w formacie BASE/QUOTE (np. BTC/USDT).

Schemat odpowiedzi

{
  "exchange": "binance",
  "pair": "BTC/USDT",
  "timestamp": "2026-04-24T14:03:00Z",
  "last": 80934.19,
  "bid": 80932.50,
  "ask": 80936.22,
  "bidVolume": 1.10500,
  "askVolume": 1.32000,
  "high": 81920.00,
  "low": 80120.00,
  "open": 80214.00,
  "close": 80934.19,
  "previousClose": 80214.00,
  "average": 80574.10,
  "vwap": 80651.42,
  "baseVolume": 11744.6152,
  "quoteVolume": 946812440.18,
  "change": 720.19,
  "percentage": 0.90
}

Pola

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 przechwycenia zrzutu.
last	number	Ostatnia cena transakcji.
bid	number	Najlepsza cena oferty kupna.
ask	number	Najlepsza cena oferty sprzedaży.
bidVolume	number	Wielkość dostępna po najlepszej cenie kupna. Może być niedostępna na niektórych giełdach.
askVolume	number	Wielkość dostępna po najlepszej cenie sprzedaży. Może być niedostępna na niektórych giełdach.
high	number	Najwyższa cena transakcji w ciągu ostatnich 24 godzin.
low	number	Najniższa cena transakcji w ciągu ostatnich 24 godzin.
open	number	Cena otwarcia bieżącego okna 24-godzinnego.
close	number	Cena zamknięcia bieżącego okna 24-godzinnego. Zazwyczaj równa ostatniej cenie.
previousClose	number	Cena zamknięcia poprzedniego okna 24-godzinnego. Może być niedostępna na niektórych giełdach.
average	number	Średnia z ceny otwarcia i zamknięcia. Może być niedostępna na niektórych giełdach.
vwap	number	24-godzinna cena średnioważona wolumenem. Może być niedostępna na niektórych giełdach.
baseVolume	number	24-godzinny wolumen w walucie podstawowej.
quoteVolume	number	24-godzinny wolumen w walucie kwotowanej. Może być niedostępny na niektórych giełdach.
change	number	Bezwzględna zmiana ceny w ciągu ostatnich 24 godzin (last - open).
percentage	number	Procentowa zmiana w ciągu ostatnich 24 godzin.

Ceny i wielkości są zwracane jako liczby JSON. Klienci, którzy wymagają dokładnej precyzji do obliczeń związanych z realizacją zleceń, powinni przekonwertować je na typ dziesiętny natychmiast po parsowaniu. Zobacz model danych dla konwencji.

Metryki pochodne

Schemat tickera jest celowo kompaktowy. Metryki pochodne są obliczane po stronie klienta:

Metryka	Obliczenie
Spread (bezwzględny)	ask - bid
Spread (punkty bazowe)	(ask - bid) / punkt środkowy × 10_000
Punkt środkowy	(bid + ask) / 2

Model lub twój kod wykonuje te obliczenia po zwróceniu tickera. Nie jest potrzebne dodatkowe wywołanie narzędzia.

Aktualność

Odpowiedzi tickera odzwierciedlają bieżący stan giełdy źródłowej w momencie żądania. Pole timestamp rejestruje, kiedy zrzut został przechwycony.

Dane giełdy źródłowej aktualizują się wiele razy na sekundę. MCP nie udostępnia trybu streamingowego tickera; każde wywołanie to świeże pobranie danych w danym momencie. Dla większości przepływów pracy agentów AI odświeżanie tickerów co kilka sekund lub minut jest odpowiednie. Dla danych tick-po-ticku właściwym narzędziem jest websocket giełdy — nie do tego został zaprojektowany MCP.

Koszt

Aspekt	Koszt
Na wywołanie	1 jednostka wywołania na wszystkich poziomach
Wariant historyczny	Nieobsługiwany — historia tickera nie jest dostępna przez MCP. Do analizy szeregów czasowych użyj get_candles.

Charakterystyka skalowania

Wywołania tickera są najtańszym i najszybszym typem danych w MCP. Typowe wzorce użytkowania:

• Szerokie skanowanie. Pobieranie tickerów dla 200 najlepszych par giełdy zużywa 200 jednostek wywołań — dobrze w ramach tygodniowego limitu każdego poziomu.
• Porównanie wielogiełdowe. Pobieranie tej samej pary z 5 giełd to 5 jednostek wywołań.
• Przegląd listy obserwowanych. Lista 20 par odświeżana co godzinę to 480 wywołań dziennie, 3 360 tygodniowo — mieści się wygodnie w darmowym poziomie Pioneer.

Dla wzorca projektowego, który wykorzystuje niski koszt tickera, zobacz wzorce promptów i praktyczny przewodnik po danych tickera.

Przykładowe wywołania

Podstawowy zrzut

Zapytane w kliencie MCP:

Jaki jest bieżący ticker BTC/USDT na Binance?

Agent wywołuje get_ticker(exchange="binance", pair="BTC/USDT") i zwraca zrzut.

Porównanie międzygiełdowe

Porównaj tickery BTC/USDT na Binance, Coinbase, Kraken i OKX. Który ma obecnie najwęższy spread?

Agent wywołuje get_ticker cztery razy, raz na giełdę, oblicza spready lokalnie i zwraca ranking.

Przegląd listy obserwowanych

Dla każdego z BTC, ETH, SOL, ARB, OP, pobierz bieżący ticker z Binance i podsumuj w tabeli.

Agent wywołuje get_ticker pięć razy i prezentuje wyniki w formie tabeli.

Błędy

Kod błędu	Przyczyna
UNAUTHORIZED	Klucz API nieprawidłowy lub odwołany.
EXCHANGE_NOT_SUPPORTED	Giełda niedostępna na aktywnym poziomie.
PAIR_NOT_FOUND	Para nie istnieje na określonej giełdzie.
INVALID_PARAMETER	Argument nie przeszedł walidacji (np. źle sformatowany symbol pary).
EXCHANGE_UNAVAILABLE	Giełda źródłowa nie odpowiada.
RATE_LIMIT_EXCEEDED	Osiągnięto limit szybkości krótkiego interwału.
QUOTA_EXCEEDED	Osiągnięto tygodniowy limit.

Dostęp poziomów

Zapytania tickera są dostępne na wszystkich poziomach (Pioneer, Explorer, Adventurer, Hero).

Obowiązuje ograniczenie pokrycia giełd: na poziomie Pioneer zapytania tickera są ograniczone do Binance, Coinbase i Kraken. Na poziomie Explorer i wyższych dostępnych jest więcej giełd. Zobacz obsługiwane giełdy.