Orderboek tool referentie

Deze pagina is de tool referentie voor het ophalen van orderboek snapshots van de Cryptohopper Market Data MCP. Voor de conceptuele gids, zie een praktische gids voor crypto orderboek data.

Tool naam

get_orderbook

Doel

Retourneert een momentopname van het orderboek voor een gespecificeerd paar op een gespecificeerde beurs. Bevat de huidige rustende biedingen en vraagprijzen met prijs en grootte per niveau.

Argumenten

Argument	Type	Vereist	Beschrijving
exchange	string	Ja	Beurs-identificatie (kleine letters).
pair	string	Ja	Paar in BASE/QUOTE formaat (bijv. BTC/USDT).
depth	integer	Nee	Maximaal aantal niveaus om te retourneren per kant. Standaard is beursafhankelijk. Bovengrens is upstream-afhankelijk.

Response schema

{
  "exchange": "binance",
  "pair": "BTC/USDT",
  "timestamp": "2026-04-24T14:03:00Z",
  "bids": [
    [80934.18, 5.32816],
    [80930.05, 1.10000],
    [80925.40, 3.40000]
  ],
  "asks": [
    [80936.22, 1.20000],
    [80940.00, 2.50000],
    [80945.75, 0.80000]
  ]
}

Velden

Veld	Type	Beschrijving
exchange	string	De beurs-identificatie waar de data vandaan kwam.
pair	string	Het paar, in BASE/QUOTE formaat.
timestamp	string (ISO-8601)	Opnametijd van de snapshot.
bids	array	Array van [prijs, grootte] tuples, gesorteerd op prijs aflopend (hoogste bod eerst).
asks	array	Array van [prijs, grootte] tuples, gesorteerd op prijs oplopend (laagste vraagprijs eerst).

Prijzen en groottes worden geretourneerd als JSON nummers. Clients die exacte precisie nodig hebben voor uitvoerings-gerelateerde berekeningen moeten ze onmiddellijk na het parsen converteren naar een decimaal type. Zie data model voor conventies.

Volgorde

• bids zijn gesorteerd aflopend op prijs. De eerste entry is het beste bod (hoogste prijs die een koper biedt).
• asks zijn gesorteerd oplopend op prijs. De eerste entry is de beste vraagprijs (laagste prijs die een verkoper vraagt).

De spread is het verschil tussen asks[0] en bids[0]. Het middelpunt is hun gemiddelde.

Diepte

Orderboek diepte varieert per beurs. De MCP retourneert wat de upstream beurs blootstelt via zijn publieke API.

Typische diepte (niveaus per kant)	Beurzen
100	Meeste grote beurzen standaard
Tot 500 of meer	Sommige beurzen, wanneer diepte wordt aangevraagd

Verzoeken voor meer diepte dan de upstream ondersteunt worden afgekapt tot het upstream maximum. Het depth argument is best-effort, niet gegarandeerd.

Versheid

Orderboeken worden vastgelegd op verzoektijd. Het timestamp veld weerspiegelt wanneer de snapshot werd gelezen van de upstream beurs.

Orderboeken worden heel snel verouderd — typisch binnen seconden op liquide paren. Clients moeten orderboek antwoorden niet cachen voor gebruik in uitvoeringsbeslissingen.

Kosten

Aspect	Kosten
Per aanroep	1 call unit op alle tiers
Historische variant	Niet ondersteund — orderboek geschiedenis is niet beschikbaar via de MCP

Voorbeeld invocaties

Basis snapshot

Gevraagd in een MCP client:

Laat me het huidige orderboek voor BTC/USDT op Binance zien.

De agent roept get_orderbook(exchange="binance", pair="BTC/USDT") aan en retourneert een snapshot.

Aangepaste diepte

Haal de top 50 niveaus van het ETH/USDT orderboek op Kraken op.

De agent roept get_orderbook(exchange="kraken", pair="ETH/USDT", depth=50) aan.

Afgeleide metrieken

De MCP retourneert ruwe niveaus; afgeleide metrieken (spread, diepte binnen X%, slippage voor een gegeven ordergrootte) worden berekend door het model of door de aanroepende code.

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 gespecificeerde beurs.
INVALID_PARAMETER	Argument faalde validatie (bijv. misvormde paar symbool, negatieve diepte).
EXCHANGE_UNAVAILABLE	Upstream beurs reageert niet.
RATE_LIMIT_EXCEEDED	Korte-interval rate limit bereikt.
QUOTA_EXCEEDED	Wekelijkse quota bereikt.

Tier toegang

Orderboek queries zijn beschikbaar op alle tiers (Pioneer, Explorer, Adventurer, Hero).

De beursdekking beperking is van toepassing: op Pioneer zijn orderboek queries beperkt tot Binance, Coinbase en Kraken. Op Explorer en hoger zijn meer beurzen beschikbaar.