wmd

wmd - WavesMarkerData

Almost complete replacement for WavesDataFeed.

WavesMarketData (wmd) is a service that offers the HTTP API similar to WavesDataFeed's API, but lacks the WebSocket API. The state of wmd could be build using initial import of a standard Waves blockchain file or synchronizing with the mother-node's API (could take a long time).

How it works

wmd starts the HTTP API and runs the synchronization with the Waves node. From that node it gets the information about new block, extracts transactions and builds historical market data in raw or candlestick formats.

Distinctions from WavesDataFeed

• ➖ No WebSocket API
• ➖ No processing of UTX transactions
• ➕ Import of binary blockchain file
• 🍴 Better forks resolution
• 🌈 Support of mother-node's rollbacks
• 💰 Correct issuer's balances calculation

Usage

usage: wmd [flags]
  -log-level        Logging level. Supported levels: DEBUG, INFO, WARN, ERROR, FATAL. Default logging level INFO.
  -import-file      Path to binary blockchain file to import before starting synchronization.
  -node             URL of Waves node API. Default value: http://127.0.0.1:6869.
  -sync-interval    Synchronization interval, seconds. Default interval is 10 seconds.
  -lag              Synchronization lag behind the node, blocks. Default value 1 block.
  -address          Local network address to bind the HTTP API of the service on. Default value is :6990.
  -db               Path to data base folder. No default value.
  -matcher          Matcher's public key in form of Base58 string. Defaults to 7kPFrHDiGw1rCm7LPszuECwWYL3dMf6iMifLRDJQZMzy.
  -scheme           Blockchain scheme symbol. Defaults to 'W'.
  -symbols          Path to file of symbol substitutions. No default value.
  -rollback         The height to rollback to before importing a blockchain file or staring the synchronization. Default value is 0 (no rollback).

In simple case, then wmd runs on the same machine where the Waves node runs, it's should be provided with parameters without default values only.

wmd -db /var/lib/wmd/db/ -symbols /var/lib/wmd/symbols.txt

Note that you have to create all the folders and give correct permissions on them. The example of symbols.txt file could be found at Github.

To quickly build the initial state of wmd, please, download the actual blockchain file and execute the following command.

wmd -db /var/lib/wmd/db/ -symbols /var/lib/wmd/symbols.txt -import-file /home/user/Downloads/mainnet-1385453.dms

HTTP API

GET - /api/status

Returns the current status of the WMD. Status contains current height of WMD's state and the ID of the last block.

CURL

curl -X GET "http://localhost:6990/api/status" \
    -H "Accept-Encoding: gzip, deflate"

GET - /api/symbols

Returns the list of asset symbols.

CURL

curl -X GET "http://localhost:6990/api/symbols" \
    -H "Accept-Encoding: gzip, deflate"

GET - /api/markets

Get the list of all markets with 24h stats.

CURL

curl -X GET "http://localhost:6990/api/markets" \
    -H "Accept-Encoding: gzip, deflate"

GET - /api/tickers

Get tickers for all markets.

CURL

curl -X GET "http://localhost:6990/api/tickers" \
    -H "Accept-Encoding: gzip, deflate"

GET - /api/ticker/{AMOUNT_ASSET}/{PRICE_ASSET}

Get ticker for a specified asset pair.

CURL

curl -X GET "http://localhost:6990/api/ticker/WAVES/BTC"

GET - /api/trades/{AMOUNT_ASSET}/{PRICE_ASSET}/{LIMIT}

Get last LIMIT confirmed trades for a specified asset pair.

CURL

curl -X GET "http://localhost:6990/api/trades/WAVES/BTC/10"

GET - /api/trades/{AMOUNT_ASSET}/{PRICE_ASSET}/{FROM_TIMESTAMP}/{TO_TIMESTAMP}

Get trades within FROM_TIMESTAMP - TO_TIMESTAMP time range.

CURL

curl -X GET "http://localhost:6990/api/trades/WAVES/BTC/1495296000000/1495296280000"

GET - /api/trades/{AMOUNT_ASSET}/{PRICE_ASSET}/{ADDRESS}/{LIMIT}

Get trades for a specified asset pair and address.

CURL

curl -X GET "http://localhost:6990/api/trades/WAVES/BTC/3PCfUovRHpCoGL54UakGBTSDEXTbmYMU3ib/10"

GET - /api/candles/{AMOUNT_ASSET}/{PRICE_ASSET}/{TIMEFRAME}/{LIMIT}

Get last LIMIT candlesticks for the specified asset pair.

CURL

curl -X GET "http://localhost:6990/api/candles/WAVES/BTC/5/10"

GET - /api/candles/{AMOUNT_ASSET}/{PRICE_ASSET}/{TIMEFRAME}/FROM_TIMESTAMP/TO_TIMESTAMP

Get candlesticks within FROM_TIMESTAMP - TO_TIMESTAMP time range for the specified asset pair.

CURL

curl -X GET "http://localhost:6990/api/candles/WAVES/BTC/5/1495296000000/1495296280000"