Gegevensmodel

Deze pagina beschrijft het gemeenschappelijke gegevensmodel dat wordt gedeeld door de marktdatatools van de Cryptohopper MCP. De drie primaire gegevenstypen — ticker, orderboek en kaars — hebben elk hun eigen referentiepagina met het exacte responsschema:

• Ticker tool referentie
• Orderboek tool referentie
• Kaars tool referentie

Deze pagina documenteert de conventies die gemeenschappelijk zijn voor alle drie.

Conventies

Symboolformaat

Alle paarsymbolen gebruiken het BASIS/QUOTE-formaat:

Voorbeeld	Basis	Quote
BTC/USDT	BTC	USDT
ETH/USD	ETH	USD
SOL/USDC	SOL	USDC

Het formaat wordt server-side genormaliseerd. Upstream-beurzen gebruiken verschillende notaties (bijv. BTCUSDT, BTC-USDT, tBTCUSDT); de MCP presenteert een uniform BASIS/QUOTE-formaat, ongeacht de upstream-conventie.

Zie ondersteunde beurzen voor de lijst met beurzen die de MCP kan bevragen.

Beurs-identificatoren

Beursnamen in verzoeken en responses gebruiken kleine letters als identificatoren:

Identificator	Beurs
binance	Binance
coinbase	Coinbase
kraken	Kraken
bybit	Bybit
okx	OKX

De volledige lijst wordt geretourneerd door de list-exchanges tool en gedocumenteerd in ondersteunde beurzen.

Tijdstempels

Alle tijdstempels in responses zijn UTC en ISO-8601 geformatteerd: 2026-04-24T14:03:00Z

Numerieke tijdstempels, waar deze worden weergegeven (bijvoorbeeld binnen kaarsrecords), zijn Unix-tijdstempels in milliseconden.

Decimale codering

Prijs- en groottewaarden worden geretourneerd als JSON-nummers (floats). Voorbeelden van elke tool:

// 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]

Omdat JSON-nummers in de meeste talen worden geparsed als IEEE-754 floating-point, moeten clients die exacte precisie vereisen (bijvoorbeeld bij het berekenen van ordergroottes) deze waarden onmiddellijk na het parsen converteren naar een decimaal type — bijvoorbeeld Python's Decimal, JavaScript's BigNumber.js, of een equivalent.

Optionele velden

Sommige velden zijn optioneel en kunnen ontbreken in responses wanneer de upstream-beurs ze niet verstrekt. Clients moeten ontbrekende velden behandelen als null in plaats van als een fout.

Gemeenschappelijke velden

Drie velden verschijnen in de meeste responses:

Veld	Type	Beschrijving
exchange	string	De beurs-identificator waarvan de gegevens afkomstig zijn.
pair	string	Het paar in BASIS/QUOTE-formaat.
timestamp	string (ISO-8601)	Het tijdstip waarop de gegevens zijn vastgelegd.

De overige velden zijn afhankelijk van de tool. Volledige schema's volgen hieronder.

Ticker-schema (samenvatting)

Een ticker-response is een enkel object dat de huidige staat van een markt beschrijft. Veldnamen volgen CCXT-conventies.

Velden omvatten:

• last — laatst verhandelde prijs
• bid — beste biedprijs
• ask — beste vraagprijs
• bidVolume — grootte bij het beste bod
• askVolume — grootte bij de beste vraagprijs
• high — 24-uurs hoogste prijs
• low — 24-uurs laagste prijs
• open — openingsprijs voor het 24-uurs venster
• close — sluitingsprijs voor het 24-uurs venster (meestal gelijk aan last)
• previousClose — sluitingsprijs van het vorige 24-uurs venster
• average — gemiddelde van open en close
• vwap — 24-uurs volume-gewogen gemiddelde prijs
• baseVolume — 24-uurs volume in het basisbezit
• quoteVolume — 24-uurs volume in het quotebezit
• change — 24-uurs absolute prijsverandering
• percentage — 24-uurs procentuele verandering

Zie ticker tool referentie voor het volledige schema en veldtypen.

Orderboek-schema (samenvatting)

Een orderboek-response bevat twee arrays — bids en asks — waarbij elk element een [prijs, grootte] tuple is:

• bids — array van [prijs, grootte] paren, gesorteerd op prijs aflopend (hoogste bod eerst)
• asks — array van [prijs, grootte] paren, gesorteerd op prijs oplopend (laagste vraagprijs eerst)

De diepte van elke kant hangt af van de upstream-beurs. Zie orderboek tool referentie voor details.

Kaars-schema (samenvatting)

Een kaars-response is een array van OHLCV-records, chronologisch geordend (standaard oudste eerst). Elk record is zelf een array met zeven posities:

Index	Veld	Beschrijving
0	timestamp	Openingstijd van de balk (Unix-tijdstempel in milliseconden)
1	open	Openingsprijs
2	high	Hoogste prijs in de balk
3	low	Laagste prijs in de balk
4	close	Sluitingsprijs
5	volume	Basisvaluta-volume verhandeld in de balk
6	count	Aantal transacties in de balk

Voorbeeld:

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

Zie kaars tool referentie voor het volledige schema, ondersteunde tijdsbestekken en terugkijk-semantiek.

Foutresponses

Wanneer een toolaanroep mislukt, volgt de response de MCP-foutenvelop:

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