Api based - pull


  • API reachable from our IP addresses:

    • - New

    • - New

    • Old. IP is not valid from June 1st, 2023.

    • - Old. IP is not valid from June 1st, 2023.

You need to have those IPs whitelisted. For LND we support both gRPC (usually on TCP port 10009) and REST API (usually running on TCP port 8080), so either of them should be enough (we prefer gRPC though). For CoreLightning we use commando so only lightning port (TCP 9735) should be reachable from our IPs (usually is is open for everyone already since else nobody can open a channel with your node).

Enroll your node

Click on the button “Enroll in Liquidops” to initiate the configuration

In the next step you can choose how you want to enroll your node:

Click "Continue" for either "CoreLightning Node" or "LND Node".

In the next step you have to enter node connection details


On LND nodes, macaroon files can be found under ~/.lnd/data/chain/bitcoin/mainnet.

By default, the readonly.macaroon file is binary. We will convert it into an hexadecimal format with the command xxd.

cd ~/.lnd/data/chain/bitcoin/mainnet

xxd -p -c 10000 readonly.macaroon

The command returns an hexadecimal string.


Copy the hexadecimal string returned by the command and paste in into the macaroon field:

Then do the same with certificate which we first need to convert to base64

cd ~/.lnd
base64 -w 10000 tls.cert

Now you need to configure the api endpoint

If all the information inserted was correct you now press "save macaroon" button and you will see Liquidops enabled for your node


For CLN you just need node address and a read-only rune. Rune can be obtained using lightning-cli commando-rune restrictions=readonly on your CLN node and copying rune field. Note that doing this will automatically enable commando plugin.

An example rune looks like this:


Copy your value to Rune input and press save rune button.

Liquidops enabled

After saving the data you should see:

and the data being pulled from your node briefly and extra options unlocked to create new alerts under Manage alerts

Last updated