Ticker-tool referentie
Deze pagina is de tool-referentie voor het ophalen van ticker-snapshots uit de Cryptohopper Market Data MCP.
Tool naam
get_ticker
Doel
Retourneert een momentopname van de huidige staat van een markt voor een opgegeven paar op een opgegeven beurs. Bevat de laatst verhandelde prijs, hoogste bod en laagste vraagprijs, 24-uurs bereik, 24-uurs volume en 24-uurs verandering.
Argumenten
| Argument | Type | Vereist | Beschrijving |
|---|---|---|---|
| exchange | string | Ja | Beurs-identificatie (kleine letters). |
| pair | string | Ja | Paar in BASIS/QUOTE-formaat (bijv. BTC/USDT). |
Response schema
{
"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
}
Velden
| Veld | Type | Beschrijving |
|---|---|---|
| exchange | string | De beurs-identificatie waarvan de gegevens afkomstig zijn. |
| pair | string | Het paar, in BASIS/QUOTE-formaat. |
| timestamp | string (ISO-8601) | Vastlegtijd van de snapshot. |
| last | number | Laatst verhandelde prijs. |
| bid | number | Hoogste bod. |
| ask | number | Laagste vraagprijs. |
| bidVolume | number | Grootte bij het hoogste bod. Kan bij sommige beurzen afwezig zijn. |
| askVolume | number | Grootte bij de laagste vraagprijs. Kan bij sommige beurzen afwezig zijn. |
| high | number | Hoogste handelsprijs in de afgelopen 24 uur. |
| low | number | Laagste handelsprijs in de afgelopen 24 uur. |
| open | number | Openingsprijs van het huidige 24-uurs venster. |
| close | number | Sluitingsprijs van het huidige 24-uurs venster. Meestal gelijk aan last. |
| previousClose | number | Sluitingsprijs van het vorige 24-uurs venster. Kan bij sommige beurzen afwezig zijn. |
| average | number | Gemiddelde van open en close. Kan bij sommige beurzen afwezig zijn. |
| vwap | number | 24-uurs volume-gewogen gemiddelde prijs. Kan bij sommige beurzen afwezig zijn. |
| baseVolume | number | 24-uurs volume in het basisbezit. |
| quoteVolume | number | 24-uurs volume in het quotebezit. Kan bij sommige beurzen afwezig zijn. |
| change | number | Absolute prijsverandering over de afgelopen 24 uur (last ? open). |
| percentage | number | Procentuele verandering over de afgelopen 24 uur. |
Prijzen en groottes worden geretourneerd als JSON-nummers. Clients die exacte precisie nodig hebben voor uitvoeringsberekeningen moeten ze onmiddellijk na het parsen converteren naar een decimaal type. Zie datamodel voor conventies.
Afgeleide metrieken
Het ticker-schema is opzettelijk compact. Afgeleide metrieken worden aan de clientzijde berekend:
| Metriek | Berekening |
|---|---|
| Spread (absoluut) | ask ? bid |
| Spread (basispunten) | (ask ? bid) / midpoint × 10_000 |
| Midpoint | (bid + ask) / 2 |
Het model of jouw code voert deze berekeningen uit nadat de ticker is geretourneerd. Er is geen extra tool-aanroep nodig.
Versheid
Ticker-respons weerspiegelen de huidige staat van de upstream beurs op het moment van de aanvraag. Het timestamp-veld registreert wanneer de snapshot is vastgelegd.
De onderliggende beursdata wordt vele malen per seconde bijgewerkt. De MCP biedt geen streaming ticker-modus; elke aanroep is een nieuwe momentopname. Voor de meeste AI-agent workflows is het vernieuwen van tickers om de paar seconden tot minuten passend. Voor tick-by-tick data is een beurs-websocket het juiste gereedschap — daar is de MCP niet voor ontworpen.
Kosten
| Aspect | Kosten |
|---|---|
| Per aanroep | 1 aanroep-eenheid op alle tiers |
| Historische variant | Niet ondersteund — ticker-geschiedenis is niet beschikbaar via de MCP. Gebruik get_candles voor tijdreeksanalyse. |
Schaaleigenschappen
Ticker-aanroepen zijn het goedkoopste en snelste datatype in de MCP. Typische gebruikspatronen:
- Brede scans. Het ophalen van tickers voor de top 200 paren van een beurs kost 200 aanroep-eenheden — ruim binnen het wekelijkse quotum van elke tier.
- Multi-beursvergelijking. Het ophalen van hetzelfde paar op 5 beurzen kost 5 aanroep-eenheden.
- Watchlist sweeps. Een 20-paar watchlist die elk uur wordt vernieuwd is 480 aanroepen per dag, 3.360 per week — past comfortabel binnen de gratis Pioneer tier.
Voor het ontwerppatroon dat gebruikmaakt van de lage kosten van tickers, zie promptpatronen en een praktische gids voor tickerdata.
Voorbeeld invocaties
Basis snapshot
Gevraagd in een MCP client:
Wat is de huidige BTC/USDT ticker op Binance?
De agent roept get_ticker(exchange="binance", pair="BTC/USDT") aan en retourneert de snapshot.
Vergelijking tussen beurzen
Vergelijk BTC/USDT-tickers op Binance, Coinbase, Kraken en OKX. Welke heeft nu de kleinste spread?
De agent roept get_ticker vier keer aan, één keer per beurs, berekent lokaal de spreads en retourneert een ranking.
Watchlist sweep
Haal voor elk van BTC, ETH, SOL, ARB, OP de huidige ticker van Binance op en vat samen in een tabel.
De agent roept get_ticker vijf keer aan en presenteert de resultaten in tabelvorm.
Fouten
| Foutcode | Oorzaak |
|---|---|
| UNAUTHORIZED | API-sleutel ongeldig of ingetrokken. |
| EXCHANGE_NOT_SUPPORTED | Beurs niet beschikbaar op de actieve tier. |
| PAIR_NOT_FOUND | Paar bestaat niet op de opgegeven beurs. |
| INVALID_PARAMETER | Argument faalde validatie (bijv. onjuist paar-symbool). |
| EXCHANGE_UNAVAILABLE | Upstream beurs reageert niet. |
| RATE_LIMIT_EXCEEDED | Korte-interval snelheidslimiet bereikt. |
| QUOTA_EXCEEDED | Wekelijks quotum bereikt. |
Tier-toegang
Ticker-queries zijn beschikbaar op alle tiers (Pioneer, Explorer, Adventurer, Hero).
De beperking van beursdekking is van toepassing: op Pioneer zijn ticker-queries beperkt tot Binance, Coinbase en Kraken. Op Explorer en hoger zijn meer beurzen beschikbaar. Zie ondersteunde beurzen.