Bisq Markets Website+API

A simple web interface to view Bisq markets.

This is a bare-bones implementation that reads the JSON files created by Bisq and publishes an API for web clients to access them.

Performance, or lack thereof.

At present, no database is used and backend operations are very inefficient.

This is OK for the moment as there is little Bisq data, but the implementation will need to be optimized when Bisq volume picks up.

I have separated the data access classes such that it should be simple to plugin more efficient strategies.

Requirements

• Ubuntu 18.04 LTS

Installation

First, setup your Bisq Seednode so you have Bisq running and fully synced. Then, run the intallation script from this repo to install Bisq Markets API into the Apache webroot.

curl -s https://raw.githubusercontent.com/bisq-network/bisq-markets/master/install_bisq_markets_debian.sh | sudo bash

Navigate in your browser to your webserver docroot.

Let's Encrypt

You'll need to open ports 80 and 443 on your firewall for HTTP and HTTPS

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Request an SSL certificate for your server's hostname using certbot

sudo apt-get install -y python-certbot-apache
sudo certbot --apache -d markets.example.com

CORS headers (optional)

If necessary, add this to your apache2.conf in the <VirtualHost> section:

Header always set Access-Control-Allow-Origin "*"

If not already enabled, you will need to enable the Headers module by doing

ln -s /etc/apache2/mods-available/headers.load /etc/apache2/mods-enabled/

Tweaks for scaling (optional)

Recommended to set in /etc/php/7.2/apache2/php.ini

memory_limit = 512M

Recommended to set in /etc/apache2/mods-available/mpm_prefork.conf

<IfModule mpm_prefork_module>
        StartServers             20
        MinSpareServers          10
        MaxSpareServers          20
        MaxRequestWorkers        50
        MaxConnectionsPerChild   0
</IfModule>

API

For now, just check out the API subdirectory. docs are todo.