Live

Voor ontwikkelaars

Widgets en API

Zet de live tape op je eigen site met één regel code, of bouw zelf met de JSON-API. Gratis, zonder account of sleutel, met data van Bitvavo, Kraken, Coinbase, Bitstamp, Binance, OKX en Bybit.

Widgets

Kies een widget en stel hem in. Het voorbeeld rechts is echt en live. Kopieer de code naar je site: embed.js maakt er een iframe van die zijn hoogte zelf aanpast.

Thema

Instellingen

AttribuutParameterVoorWaarden
data-ewp-widgetpadalletape, ticker, walvis, blokken, scherm
data-coincointape, blokkenSymbool, bijv. btc. Leeg = alle munten.
data-minmintape, scherm0, 1000, 10000, 100000 (euro)
data-rowsrowstape, blokken, scherm3 tot 25 (scherm: tot 12), standaard 8
data-themethemealle behalve schermlight of dark. Het scherm is altijd donker.
data-height–alleStarthoogte in pixels, tot de widget zijn eigen hoogte doorgeeft

Widgets later in de pagina toegevoegd (bijvoorbeeld in een single-page app)? Roep daarna window.eWallPrints.render() aan.

API

Alle eindpunten zijn GET, geven JSON terug en mogen vanuit elke browser worden aangeroepen (CORS staat open). Elk antwoord heeft dezelfde vorm:

{ "success": true,  "data": { … } }
{ "success": false, "error": "Onbekende munt" }

Basis-URL: https://e-wallprints.nl

GET /api/v1/live Cache: Niet cachen

Laatste prints en koop/verkoopdruk

De nieuwste prints van alle beurzen, nieuwste het laatst, met per munt de koop- en verkoopdruk van het afgelopen uur. Ververst elke seconde. Gebruik since om alleen nieuwe prints op te halen.

ParameterVerplichtUitleg
coinneeSymbool, bijv. btc. Leeg = alle munten.
minneeMinimale waarde in euro: 0, 1000, 10000, 100000. Standaard 1000.
sinceneeAlleen prints met een hoger seq dan dit. Gebruik de seq uit het vorige antwoord.
venueneeEén beurs: bitvavo, kraken, coinbase, bitstamp, binance, okx, bybit. Dan zonder koop/verkoopdruk en standaard zonder minimumwaarde.
curl "https://e-wallprints.nl/api/v1/live"
GET /api/v1/today Cache: Elke 3 seconden nieuw

Dagtotalen en blokken van vandaag

Totalen sinds middernacht (Europe/Amsterdam): aantal prints, verhandelde waarde, blokken en walvissen, per beurs. Plus de grootste blokken (top) en de nieuwste (recent).

ParameterVerplichtUitleg
limitneeMaximaal aantal blokken in top en recent, 0–500. Standaard alles.
curl "https://e-wallprints.nl/api/v1/today"
GET /api/v1/whale Cache: Vandaag 10 s, eerdere dagen 1 dag

Walvis van de dag

De grootste print van een dag, de vier daarna en de dagtotalen. Vandaag kan nog veranderen (live: true); een afgelopen dag staat vast.

ParameterVerplichtUitleg
dayneeDatum als JJJJ-MM-DD. Leeg = vandaag.
curl "https://e-wallprints.nl/api/v1/whale"
GET /api/v1/prices Cache: 5 seconden

Prijzen en 24-uursverandering

Per munt de laatste prijs in euro, de verandering in 24 uur (procent), hoog, laag en verhandelde waarde. Bron: Bitvavo.

curl "https://e-wallprints.nl/api/v1/prices"
GET /api/v1/coins Cache: 5 seconden

Alle munten in één keer

Per munt de prijs en 24-uursverandering, de totalen van vandaag (prints, waarde, blokken, walvissen), het aantal blokken en de koopdruk van het afgelopen uur. Dit voedt de pagina Koersen.

curl "https://e-wallprints.nl/api/v1/coins"
GET /api/v1/venues Cache: 5 seconden

Beurzen en marktaandeel

Per beurs de munteenheden, de markten die we volgen en de totalen van vandaag met het marktaandeel in procenten, grootste eerst.

curl "https://e-wallprints.nl/api/v1/venues"
GET /api/v1/spread Cache: 5 seconden

Prijs per beurs

Per munt de laatste prijs op elke beurs, ook omgerekend naar euro (eur), met de laagste, de hoogste en het verschil in procenten.

curl "https://e-wallprints.nl/api/v1/spread"
GET /api/v1/status Cache: Niet cachen

Status van de feeds

Per beurs of de feed verbonden is, sinds wanneer, het laatste bericht, prints in de laatste minuut en het aantal herverbindingen.

curl "https://e-wallprints.nl/api/v1/status"
GET /api/v1/candles Cache: 60 seconden

Koershistorie, 24 uur

Slotkoersen per 5 minuten over de laatste 24 uur, oudste eerst, als { t, c }: tijd in milliseconden en koers in euro.

ParameterVerplichtUitleg
coinjaSymbool, bijv. eth.
curl "https://e-wallprints.nl/api/v1/candles"

Datamodel: een print

Elke handel heeft dezelfde vorm, van welke beurs hij ook komt. Waarde in euro reken je zelf uit: price × qty, en bij USD of USDT maal usdToEur uit hetzelfde antwoord.

VeldTypeUitleg
idstring | numberTrade-ID van de beurs. Uniek samen met venue.
seqnumberVolgnummer van eWallPrints, oplopend. Voor since.
tsnumberTijdstip van de handel in milliseconden (Unix).
coinstringSymbool, bijv. BTC.
pricenumberPrijs per munt in cur.
qtynumberAantal munten.
curstringEUR, USD of USDT. Waarde = price × qty in deze munteenheid.
sidestringbuy of sell: de kant van wie de handel startte (de taker).
venuestringBeurs: Bitvavo, Kraken, Coinbase, Bitstamp, Binance, OKX, Bybit.
rationumber | nullAlleen bij blokken: hoeveel keer groter dan de gemiddelde print in die munt.

Een print is een blok vanaf €100.000 en een walvis vanaf €1.000.000. USDT en USDC rekenen we als USD.

Live volgen

Vraag elke 1 à 2 seconden /api/v1/live op en geef de seq uit het vorige antwoord mee als since. Dan krijg je alleen wat nieuw is, en mis je niets: ook een print die later binnenkomt krijgt een hoger volgnummer.

JavaScript
let since = 0;

async function poll() {
  const url = 'https://e-wallprints.nl/api/v1/live?coin=btc&min=10000&since=' + since;
  const res = await fetch(url);
  const { success, data } = await res.json();
  if (success) {
    for (const p of data.tape) {          // oudste eerst
      console.log(p.venue, p.side, p.qty, p.coin, '@', p.price, p.cur);
    }
    since = data.seq;                     // volgende keer alleen nieuwe prints
  }
  setTimeout(poll, 1500);
}

poll();

Voorwaarden

Gebruik

  • Gratis, ook commercieel. Geen sleutel nodig.
  • Vermeld de bron met een link naar eWallPrints.nl. De widgets doen dat al.
  • Houd het redelijk: live hooguit één keer per seconde per bezoeker, de rest volgens de cache-tijd hierboven.
  • Geen garantie op beschikbaarheid. Geen beleggingsadvies.

Statuscodes

200Gelukt
400Ongeldige parameter, zoals een onbekende munt
404Niet gevonden, zoals een dag zonder walvis
503Tijdelijk geen live-data: de feeds worden opnieuw verbonden