Transaction history widget

This document describes the steps to take in order to embed the BTC Direct trade history widget in another website. It is aimed at developers that will implement this functionality.

Implementing the widget

In order to enable the widget in your website, the following script needs to be embedded. This script loads the widget from the BTC Direct CDN (Content Delivery Network) and initializes it automatically.

<script lang="js">
    (function (btc, d, i, r, e, c, t) {
        btc[r] = btc[r] || function() {
            (btc[r].q = btc[r].q || []).push(arguments)
        };
        c = d.createElement(i);
        c.id = r; c.src = e; c.async = true;
        c.type = 'module'; c.dataset.btcdirect = '';
        t = d.getElementsByTagName(i)[0];
        t.parentNode.insertBefore(c, t);
    })(window, document, 'script', 'btcdirect',
        'https://cdn.btcdirect.eu/transaction-history/transaction-history.js'
    );

    btcdirect('init', { token: 'API_KEY' });
</script>

If a valid key is provided, and the styling is added, it will result in the following:

Note that if the user is not logged in, the login form will be displayed instead.

Optional init call parameters

The init call, as described in Getting Started, can contain several key-value pairs to fine-tune the widget. The different options are described here.

Additional calls to the widget

The widget accepts several calls to it with which additional information can be provided. These can be added to the script tag that loads the widget.

Locale

This call sets the locale for the application. This determines the way monetary values are displayed. For example 0 Euro’s in the EN-GB locale is displayed as “€0.00” whereas the NL-NL locale results in ”€ 0,00”.

btcdirect('locale', { locale: 'en-GB' });