Here you can see our API endpoints:

/blockchain

Returns the wallet version used by the service, current block and it's corresponding hash.

API Endpoint

GET {{ apiEndpoint }}/blockchain

Example Request

curl -sX GET {{ apiEndpoint }}/blockchain

Example Response

{
  "blocks": 24346,
  "blocks_hash": "31344f837d44a6e8b3a14e77ec47b7ba8a3e17eb3c21e3ee0d42c28c24a6ee10",
  "wallet_version": "1.4.0"
}

/masternodes

Returns all the MasterNodes available with some stats precalculated in the backend.

API Endpoint

GET {{ apiEndpoint }}/masternodes

Example Request

curl -sX GET {{ apiEndpoint }}/masternodes

Example Response

{
  "nodes": [
    {
      "ip": "13.126.0.181",
      "port": 51434,
      "address": "y4abJGsgj6SM8JgqENkFRCQ1erybkSagTU",
      "protocol": 70002,
      "wallet": "",
      "status": "ENABLED",
      "active_time": 553574,
      "last_paid": 1522489400,
      "paid_block": 0,
      "listen": -1,
      "voting": 33
    },
    {
      "ip": "207.246.72.175",
      "port": 51434,
      "address": "yEzMRwe8wj9pnwnxLESdVg3nQqWfRCDs8F",
      "protocol": 70002,
      "wallet": "4.1.2",
      "status": "ENABLED",
      "active_time": 1478880,
      "last_paid": 1522489133,
      "paid_block": 0,
      "listen": 1,
      "voting": 0
    }
  ],
  "statuses": [
    {
      "status": "ENABLED",
      "count": 2
    }
  ],
  "total_nodes": 2,
  "blocks": 0,
  "error": "",
  "tech": "dash",
  "api_ver": "3.1.0",
  "time": 1530866854
}

Where these MasterNode fields are optional:

  • paid_block will only be displayed for chains that expose this field, like Dash forks.
  • voting available for chains that have governance compatible and enabled in our backend.

/proposals

Returns the governance proposals available on the blockchain.

API Endpoint

GET {{ apiEndpoint }}/proposals

Example Request

curl -sX GET {{ apiEndpoint }}/proposals

Example Response

{
  "active_proposals": [
    {
      "name": "Cryptopia listing",
      "url": "https://github.com/example/proposals/issues/121",
      "pay_addr": "y1UoitLwvnb4YRYsjeLeyUkyKqje9VkXQ8",
      "hash": "a19b5977de571050d625d111d5e0b0bd7ce3f4d1fb95e25946d6b2e09a9e9c19",
      "votes": "2/0/0",
      "block_start": 5616,
      "block_end": 42736,
      "start_time": "2018-03-11T22:24:07Z",
      "end_time": "2018-04-19T12:14:21Z",
      "payments": "12/26",
      "monthly_pay": 1150,
      "total_pay": 29900
    }
  ],
  "past_proposals": [
    {
      "name": "Meetup presentation",
      "url": "https://github.com/example/proposals/issues/203",
      "pay_addr": "y2yhgYbrT78FtLQNXhGyyAhFV4trssCR25",
      "hash": "cf7428634a8743a7b64651b154b82ff31c8d9ef94aa6879f047a8646d9e59a44",
      "votes": "2/0/0",
      "block_start": 23040,
      "block_end": 24481,
      "start_time": "2018-03-30T00:59:16Z",
      "end_time": "2018-03-31T12:55:43Z",
      "payments": "0/1",
      "monthly_pay": 40000,
      "total_pay": 40000
    }
  ],
  "total_proposals": {
    "active": 1,
    "past": 1
  },
  "next_superblock": 24480,
  "next_superblock_time": "2018-03-31T12:54:16Z",
  "budget_cycle_coins": 72100,
  "budget_cycle_blocks": 1440,
  "error": "",
  "tech": "PIVX",
  "api_ver": "1.6.1",
  "time": 1522492147
}