nim_nordnet_api

Okay, not really an API. Actually not even close to an API. Nordnet wasn't gonna play with me, so this ended up as an oldschool scraper.

The originale purpose to develop a sensor for https://www.home-assistant.io/

What is Nordnet

Nordnet is an online stockbroker with customers in Denmark, Norway, Sweden, and Finland. It serves stock from around the world. Checkout their website www.nordnet.dk and start trading with a low fee and an excellent UI.

What is this?

Well, this is a simple scraper. You provide the URL to the stock, and this little Nim program provide you with the latest data on the stock.

You can use this library in 3 ways:

1. Normal library, either by cloning the repo or installing with Nimble
2. CLI tool which outputs the data to the console
3. Home Assistant "plugin" to serve data to your dashboard

What not to do

You should absolutely not set the scraping interval to low (!!). This is not an API provided by Nordnet, so please use.

What's next?

Nothing. Nordnet properly changes their div-structure on monday, and then the scraping is failing.

How to use it

For all the 3 methods, you have to provide the URL to stock page. Navigate to the site, e.g. for Novo:

https://www.nordnet.dk/markedet/aktiekurser/16256554-novo-nordisk-b

Now grab the last part of the url, which is what you need:

16256554-novo-nordisk-b

You can provide multiple URLs, so repeat the above until satisfied.

Normal library

import nordnet
let nnObject = nordnetData("Novo", "16256554-novo-nordisk-b")
echo nnObject.priceLatest # The price
echo nordnetJson(nnObject) # JsonNode

CLI

Just find the url path and run:

$ nim c -d:ssl -d:release nordnet.nim
$ ./nordnet 16256554-novo-nordisk-b

Home Assistant

The following is for implementing the data in https://www.home-assistant.io/.

Compile

First compile the file:

nim c -d:ssl -d:release nordnet.nim

Config file

Then edit the config file, config.json, to your needs.

If you need to place your config file elsewhere, just edit the "config" path. Otherwise leave blank.

nano config/config.json

Auto run

Now adjust the service file and deploy for autorun:

nano nordnet.service
sudo cp nordnet.service /etc/systemd/system/nordnet.service
sudo systemctl enable nordnet
sudo systemctl start nordnet
sudo systemctl status nordnet

Node red

We are making 3 nodes:

• MQTT-in node - convert to JSON object
• Switch node - prepared for more stocks
• HA entity node - make the sensor

Graph

Now just create a sensor-graph with the sensor sensor.nordnet_novo, or use the mini-graph with the following code:

type: 'custom:mini-graph-card'
name: 'Stock: Novo'
icon: 'mdi:chart-bell-curve'
entities:
  - entity: sensor.nordnet_novo
    name: Latest price
hours_to_show: 168
points_per_hour: 30

Types

MqttInfo* = object

  MqttInfo* = object
    host*: string
    port*: int
    username*: string
    password*: string
    topic*: string
    ssl*: bool
    clientname*: string

Nordnetapi* = object

  Nordnetapi* = object
    urls*: seq[string]
    wait*: int
    refresh*: int

Nordnet* = object

  Nordnet* = object
    success*: bool
    name*: string
    epochtime*: int
    priceLatest*: float
    priceBuy*: float
    priceSell*: float
    priceHighest*: float
    priceLowest*: float
    percentToday*: float
    plusminusToday*: float
    tradeTotal*: int
    orderdepthSell*: int
    orderdepthBuy*: int

Procs

nordnetConfig*

proc nordnetConfig*(configPath = "config/config.json") =

Load the config

nordnetData*

proc nordnetData*(name, url: string): Nordnet =

Scrape the data and return the Nordnet object

(success: true, name: "Novo", epochtime: 1584771256, priceLatest: 359.35, priceBuy: 359.35, priceSell: 359.35, priceHighest: 381.5, priceLowest: 355.75, percentToday: -1.55, plusminusToday: -5.65, tradeTotal: 6914045, orderdepthSell: 0, orderdepthBuy: 0)

nordnetJson*

proc nordnetJson*(nn: Nordnet): JsonNode =

Transform the Nordnet object to a JsonNode

{
    "Novo": {
        "priceLatest": 359.35,
        "percentToday": -1.55,
        "plusminusToday": -5.65,
        "priceBuy": 359.35,
        "priceSell": 359.35,
        "priceHighest": 381.5,
        "priceLowest": 355.75,
        "tradeTotal": 6914045,
        "orderdepthBuy": 0,
        "orderdepthSell": 0,
        "epochtime": 1584771256,
        "success": true
    }
}

apiRun*

proc apiRun*() {.async.} =

Run the async scraping. This will first load the config into memory, then connect to the mqtt broker, and then do the first scraping. After the first scraping the loading time will start.