Delegations

The experimental::staking::query::delegations method returns information about your node’s staking. Currently QTUM and tQTUM (test tokens avalable at https://testnet-faucet.qtum.info/), along with Cosmos/Tendermint coins are supported.

Arguments

Structure	Type	Description
coin	string	the coin being staked
info_details	object	Cosmos Only. A standard StakingInfoDetails object.

📌 Examples

QTUM Command (testnet)

POST experimental::staking::query::delegations

{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
};

const response = await fetch("http://127.0.0.1:7783", {
  method: "POST",
  body: JSON.stringify(payload),
});

console.log(await response.json());

<?php

$payload = <<<'JSON'
{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
}
JSON;

$ch = curl_init("http://127.0.0.1:7783");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{"userpass":"RPC_UserP@SSW0RD","mmrpc":"2.0","method":"experimental::staking::query::delegations","params":{"coin":"tQTUM"},"id":0}`)

	resp, err := http.Post("http://127.0.0.1:7783", "application/json", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI("http://127.0.0.1:7783")
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "experimental::staking::query::delegations",
  "params": {
    "coin": "tQTUM"
  },
  "id": 0
}

response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body))

Show Response

Response (not currently staking)

{
  "mmrpc": "2.0",
  "result": {
    "staking_infos_details": {
      "type": "Qtum",
      "amount": "0",
      "staker": null,
      "am_i_staking": false,
      "is_staking_supported": true
    }
  },
  "id": 0
}

Response (staking active)

{
    "mmrpc": "2.0",
    "result": {
        "staking_infos_details": {
            "type": "Qtum",
            "amount": "8",
            "staker": "qbgHcqxXYHVJZXHheGpHwLJsB5epDUtWxe",
            "am_i_staking": true,
            "is_staking_supported": true
        }
    },
    "id": null
}

Tendermint Command

POST experimental::staking::delegations

{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
}

curl --url "http://127.0.0.1:7783" --data '{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
}'

import requests
import json

url = "http://127.0.0.1:7783"
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
}

response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2))

const payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
};

const response = await fetch("http://127.0.0.1:7783", {
  method: "POST",
  body: JSON.stringify(payload),
});

console.log(await response.json());

<?php

$payload = <<<'JSON'
{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
}
JSON;

$ch = curl_init("http://127.0.0.1:7783");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{"userpass":"RPC_UserP@SSW0RD","method":"experimental::staking::query::delegations","mmrpc":"2.0","params":{"coin":"ATOM","info_details":{"type":"Cosmos","limit":20,"page_number":1}}}`)

	resp, err := http.Post("http://127.0.0.1:7783", "application/json", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require 'net/http'
require 'json'
require 'uri'

uri = URI("http://127.0.0.1:7783")
payload = {
  "userpass": "RPC_UserP@SSW0RD",
  "method": "experimental::staking::query::delegations",
  "mmrpc": "2.0",
  "params": {
    "coin": "ATOM",
    "info_details": {
      "type": "Cosmos",
      "limit": 20,
      "page_number": 1
    }
  }
}

response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body))

Show Response

Response (success)

{
  "mmrpc": "2.0",
  "result": {
      "delegations": [
          {
              "validator_address": "iva1qq93sapmdcx36uz64vvw5gzuevtxsc7lcfxsat",
              "delegated_amount": "7.77",
              "reward_amount": "0.000000767283749739569999"
          }
      ]
  },
  "id": null
}

Error responses

Show Error Responses

NoSuchCoin (coin not active, or not supported)

{
  "mmrpc": "2.0",
  "error": "No such coin ATOM",
  "error_path": "lp_coins",
  "error_trace": "lp_coins:5228] lp_coins:5032]",
  "error_type": "NoSuchCoin",
  "error_data": {
      "coin": "ATOM"
  },
  "id": null
}

InvalidRequest (unsupported coin type)

{
  "mmrpc": "2.0",
  "error": "Error parsing request: unknown variant `UTXO`, expected `Qtum` or `Cosmos`",
  "error_path": "dispatcher",
  "error_trace": "dispatcher:122]",
  "error_type": "InvalidRequest",
  "error_data": "unknown variant `UTXO`, expected `Qtum` or `Cosmos`",
  "id": null
}

Delegations#

Arguments#

📌 Examples#

QTUM Command (testnet)#

Response (not currently staking)#

Response (staking active)#

Tendermint Command#

Response (success)#

Error responses#

NoSuchCoin (coin not active, or not supported)#

InvalidRequest (unsupported coin type)#