NAV
Back to blockrockZ
shell python javascript

Introduction

Welcome to the blockrockZ API! You can use our API to access the Cardano Network.

blockrockZ provides you with two different API types: the default Cardano GraphQL API and our own extended Cardano API.

Authentication

blockrockZ expects the Header X-Api-Key to be included in every API request. You can view your API-Key in your user account.

X-Api-Key: <your-api-key>

GraphQL

You can access the Cardano GraphQL API via https://api.blockrockz.io/cardano/v1/graphql

Here you can find the official documentation of Cardano's GraphQL API

Here you can find some example GraphQL queries

Test Authentication (TEST)

import requests
"""Currently, a self signed certificate is used. This will be replaced later."""
resp = requests.post("https://api.blockrockz.io/cardano/v1/graphql",headers={"X-Api-Key": "<your-api-key>"},verify=False)
resp.content

curl -X POST "https://api.blockrockz.io/cardano/v1/graphql" \
  -H "X-Api-Key: <your-api-key>" \
  -k

First of all, you should test if your API-Key works. To do this, simply send a POST Request to https://api.blockrockz.io/cardano/v1/graphql with the HTTP-Header X-Api-Key set to your Api-Key

Headers

Header Value Description
X-Api-Key <Your-Api-Key> You need to set the Header X-Api-Key for every request.

CHAIN API

The CHAIN API is the perfect tool for retrieving chain specific data

getChainMetadata

This query returns general chain metadata

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/chain/meta` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/chain/meta"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/chain/meta", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "id": 1,
  "network_name": "mainnet",
  "start_time": "Sat, 23 Sep 2017 21:44:51 GMT",
  "version": "Version {versionBranch = [12,0,2], versionTags = []}"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/chain/meta

getRecentSlot

This query returns the slot number of the most recent block

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/chain/recent-slot` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/chain/recent-slot"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/chain/recent-slot", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "block_no": 7786176,
  "slot_no": 72204454
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/chain/recent-slot

getTotalAda

This query returns the total amount of ADA on the Cardano chain

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/chain/total-ada` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/chain/total-ada"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/chain/total-ada", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "current_supply": "33611619005.82534800"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/chain/total-ada

NFT API

The NFT API gives you an easy to use access to all the NFT data you need

getNftMetadata

This query returns the metadata of a NFT

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/nft/metadata/{policy}/{name}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/nft/metadata/{policy}/{name}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/nft/metadata/{policy}/{name}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "id": 2,
  "deleted": ":("
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/nft/metadata/{policy}/{name}

URL Parameters

Parameter Description
policy the policyID of the NFT
name the name of the NFT

getNftOwnerHistory

This query returns all addresses that owned this NFT

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/nft/history/{asset}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/nft/history/{asset}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/nft/history/{asset}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "holder_address": "addr1qx9jdnpn65zjmpy6qx06e6thpvw09svq8xv3zqsuy08cumdrj0uk37y008e7q4498yhnm0fk6455x6cns4kn53qvvyftl",
  "tx_hash": "d1073e9c83c5d69e8d1dcf67e1d1de4416a93e1c83adfca9e258e49a810eb71b"
},
{
  "holder_address": "addr1qytentcy002w9pyu8038knffddd5wh0rux333cl0vw4ym2pc9jcpyqrpsf3nlru6n2e8g9j8nkjtq0zmfeqmgr73n5zsjgh58r",
  "tx_hash": "15549b8822c530f93666e3eb67ac4b5eafe2ed3bfecf92fd37eba32e69f6741e"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/nft/history/{asset}

URL Parameters

Parameter Description
asset concatination of the policyId and the hex encoded asset name

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the transaction)

TOKEN API

The TOKEN API enables you to access a variety of information about a specific token

getTokenMetadata

This query returns the metadata of a token

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/token/metadata/{asset}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/token/metadata/{asset}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/token/metadata/{asset}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "json": {
    "467ekskdlsldjk839ew9o8dst35fzfw4qdz6wgdu6gudszjbsj67i3": {
      "45ED23": {
        "decimals": "6",
        "desc": "blockrockZ is the best API",
        "description": "blockrockZ is the best API",
        "files":
          {
            "mediaType": "image/jpg",
            "name": "BLOCKROCKZ",
            "src": "ipfs://QmasfyhtHwedjdsklfdJsVjc7oCFsPnByrhLc5i9764h2"
          }
        ],
        "icon": "ipfs://QmaQMH7ybS9KmdYQp1sxcVAhwJH5cNaacpg4fTw23d4gbQ",
        "image": "ipfs://QmaQMH7ybS9KmdYQp1sxcVAhwJH5cNaacpg4fTw23d4gbQ",
        "mediaType": "image/png",
        "name": "BRKZ",
        "ticker": "BRKZ",
        "token site": "https://blockrockz.io/TOKEN",
        "website": "https://blockrockz.io",
      }
    },
    "version": "1.0"
  }
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/token/metadata/{asset}

URL Parameters

Parameter Description
asset concatination of the policyId and the hex encoded asset name

getTokenActions

This query returns all the mint and burn events of a token (asc)

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/token/actions/{asset}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/token/mints/{asset}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/token/mints/{asset}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "block": 7240867,
  "quantity": "1499999999",
  "tx_hash": "6519e8372fd7fc4f8d0a77c36fa11389b02406f77805ea78913eb6115113fc93"
},
{
  "block": 7240881,
  "quantity": "1499999999000000",
  "tx_hash": "380ddfbf46951b26f56910f06df26a9c531fb7d6da03ab0dec3c4e432b8a9bdf"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/token/mints/{assetFingerprint}

URL Parameters

Parameter Description
asset concatination of the policyId and the hex encoded asset name

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the transaction)
count 10 The number of results you will receive

getTokenHolder

This query returns a list of the holders of a token

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/token/holder/{asset}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/token/holder/{asset}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/token/holder/{asset}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "address": "addr1vywkezkwgf8e5wprf4nhm266rww8vq2papxpqgns3qrpwcg7vmd7g",
  "quantity": "868464662.89292600"
},
{
  "address": "addr1qy7wtzzttymfst2umscr6m9xxscfttk0256z85qexf0v8hzx0a8wukmahzq0vn2nqrhgeym0ue2wnufv8nr9ucljtn6s9vtk4h",
  "quantity": "159999900.00000000"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/token/holder/{asset}

URL Parameters

Parameter Description
asset concatination of the policyId and the hex encoded asset name

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the quantity)
count 10 The number of results you will receive

ACCOUNT API

The ACCOUNT API enables you to track the activity of a certain user

getAssets

This query returns all the assets a certain account holds

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/account/assets/{stakeAddress}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/account/assets/{stakeAddress}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/account/assets/{stakeAddress}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "fingerprint": "asset1rqg7y6fgqfhjfdnhdy8fhda2twdqspggnsqhgq",
  "asset_policy": "83732ff37818e7e520592fcd3e5257e429307d40a9f5437240e926de",
  "asset_name": "87345a3",
  "quantity": "1"
},
{
  "fingerprint": "asset1897pwz6s7nlpg5z7cynsyjalu2fazcp4r60tc9",
  "asset_policy": "a4c45615825acae7c4937ee4d45d2ff9a29328084e2dc34bf4af37b2",
  "asset_name": "3789462234",
  "quantity": "1"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/account/assets/{stakeAddress}

URL Parameters

Parameter Description
stakeAddress The staking address of the account you are looking for

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the transaction)
count 10 The number of results you will receive

getDelegationHistory

This query returns the historical stake distribution of a certain account

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/account/delegated/{stakeAddress}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/account/delegated/{stakeAddress}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/account/delegated/{stakeAddress}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "amount": "2036039855",
  "epoch": 339,
  "pool_address": "pool1qgmwcxs8d8qmr0vtvsqd9u8gugrventh5dcqukmu79e2sgfuu8t",
  "stake_address": "stake1u868a4h6sn4wcad6we79xvhjmycl5t6q00fljs7006ry34g7k0r3w"
},
{
  "amount": "664392662",
  "epoch": 340,
  "pool_address": "pool1qgmwcxs8d8qmr0vtvsqd9u8gugrventh5dcqukmu79e2sgfuu8t",
  "stake_address": "stake1u868a4h6sn4wcad6we79xvhjmycl5t6q00fljs7006ry34g7k0r3w"
  }

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/account/delegated/{stakeAddress}

URL Parameters

Parameter Description
stakeAddress The staking Address of the account you are looking for

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the epoch)
count 10 The number of results you will receive

getRewards

This query returns all the rewards an account ever earned from staking

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/account/rewards/{stakeAddress}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/account/rewards/{stakeAddress}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/account/rewards/{stakeAddress}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "delegated_pool": "pool1qgmwcxs8d8qmr0vtvsqd9u8gugrventh5dcqukmu79e2sgfuu8t",
  "epoch": 339,
  "lovelace": "1238105"
},
{
  "delegated_pool": "pool1qgmwcxs8d8qmr0vtvsqd9u8gugrventh5dcqukmu79e2sgfuu8t",
  "epoch": 340,
  "lovelace": "283438"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/account/rewards/{stakeAddress}

URL Parameters

Parameter Description
stakeAddress The staking Address of the account you are looking for

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the total balance)
count 10 The number of results you will receive

ADDRESS API

The ADDRESS API allows you to query for address specific information

getStakeAddress

This query returns the stake address to a shelley address

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/address/stakeAddress/{shelleyAddress}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/address/stakeAddress/{shelleyAddress}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/address/stakeAddress/{shelleyAddress}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "address": "addr1zxj47sy4qxlktqzmkrw8dahe46gtv8seakrshsqz26qnvzypw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspksr3q9nx",
  "stake_address": "stake1uxqh9rn76n8nynsnyvf4ulndjv0srcc8jtvumut3989cqmgjt49h6"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/address/stakeAddress/{shelleyAddress}

URL Parameters

Parameter Description
shelleyAddress any shelley address of the account

getAssets

This query returns all the assets a certain address holds

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/address/assets/{address}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/address/assets/{address}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/address/assets/{address}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "fingerprint": "asset1tmcm7u09cvnyudurexejqczpng5axv9vrpmttw",
  "asset_policy": "19541495605af531f317cb14d1c5baa3618f7852c032ec4a83d3dd05",
  "asset_name": "2347974",
  "quantity": "1"
},
{
  "fingerprint": "asset1gwgsdgy294gcnk4qeyeg3l4rpczaz858h3lmsk",
  "asset_policy": "5e889bcb83b884bb6d768cfc483845cd6ccee79c2b5a4a15dae7ff47",
  "asset_name": "4e23789a",
  "quantity": "1"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/address/assets/{address}

URL Parameters

Parameter Description
address the address that holds the assets

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the transaction)
count 10 The number of results you will receive

TRANSACTION API

The TRANSACTION API enables you to track your transactions information

getTxFee

This query returns the fee for a certain transaction

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/tx/fee/{tx_hash}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/tx/fee/{tx_hash}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/tx/fee/{tx_hash}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "fee": "172433",
  "id": 1000000
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/tx/fee/{tx_hash}

URL Parameters

Parameter Description
tx_hash the hash of the transaction

getTxInputs

This query returns all the inputs a transaction used (only ADA, multi assets coming soon!)

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/tx/inputs/{tx_hash}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/tx/inputs/{tx_hash}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/tx/inputs/{tx_hash}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "address": "DdzFFzCqrht2eGuvFdtP2pPxy7P9LvCUH6pFj7FJpahrEg1iox3GMjfZEkS7GAEguBB6JMF2zMtcfP7dzdiyPjVVCQ4Y6Fdtq1FQQSCN",
  "address_has_script": false,
  "data_hash": null,
  "id": 2195714,
  "index": 4,
  "payment_cred": null,
  "stake_address_id": null,
  "tx_id": 996126,
  "value": "158685237964"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/tx/inputs/{tx_hash}

URL Parameters

Parameter Description
tx_hash the hash of the transaction

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the value)
count 10 The number of results you will receive

getTxOutputs

This query returns all the outputs a transaction produced (only ADA, multi assets coming soon!)

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/tx/outputs/{tx_hash}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/tx/outputs/{tx_hash}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/tx/outputs/{tx_hash}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "address": "DdzFFzCqrhsn8kZdvdj2SAi4s3yZsEud1wBaS82u2sDhCkeVfgt77UAQnEYn8cpLrNGC6Dv5ZEZNunsNho2QNTPLuEG2TBDoV2nEACWf",
  "address_has_script": false,
  "data_hash": null,
  "id": 2205592,
  "index": 0,
  "payment_cred": null,
  "stake_address_id": null,
  "tx_id": 1000000,
  "value": "8991998000"
},
{
  "address": "DdzFFzCqrhsgtqDXxVKdT2bQNK55Di6UbaBgHAJMSEZB8anZFGAn9XG3BNnxh1UMChvVqqDGWvjWu8yYVTXUGJbNHhotJfu6v9fWDrML",
  "address_has_script": false,
  "data_hash": null,
  "id": 2205593,
  "index": 1,
  "payment_cred": null,
  "stake_address_id": null,
  "tx_id": 1000000,
  "value": "149693067531"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/tx/outputs/{tx_hash}

URL Parameters

Parameter Description
tx_hash the hash of the transaction

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the value)
count 10 The number of results you will receive

STAKEPOOL API

The STAKEPOOL API enables pool owners to track their pools performance

getStakeDistribution

This query returns information on how much stake each pool holds at a certain epoch

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/pool/stake-distribution/{epoch}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/pool/stake-distribution/{epoch}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/pool/stake-distribution/{epoch}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "lovelace": "25383763888567",
  "pool": "pool1qzlw7z5mutmd39ldyjnp8n650weqe55z5p8dl3fagac3ge0nx8l"
},
{
  "lovelace": "50826149197203",
  "pool": "pool16tcjctesjnks0p8sfrlf8f3d3vrp2fdn2msy80sgg3cdjtayu3z"
},
{
  "lovelace": "28365628129818",
  "pool": "pool1qzlwlpcsgflr9z3f24fg836tyq45p0kf5cnrp20s8v0psp6tdkx"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/pool/stake-distribution/{epoch}

URL Parameters

Parameter Description
epoch The Cardano epoch

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the amount)
count 10 The number of results you will receive

getCreatedBlocks

This query returns information on which blocks a certain pool created in a certain epoch

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/pool/blocks/{epoch}/{pool_hash}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/pool/blocks/{epoch}/{pool_hash}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/pool/blocks/{epoch}/{pool_hash}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "block_no": 6455392,
  "epoch_no": 300,
  "pool": "pool1qzlwlpcsgflr9z3f24fg836tyq45p0kf5cnrp20s8v0psp6tdkx"
},
{
  "block_no": 6455462,
  "epoch_no": 300,
  "pool": "pool1qzlwlpcsgflr9z3f24fg836tyq45p0kf5cnrp20s8v0psp6tdkx"
},
{
  "block_no": 6456720,
  "epoch_no": 300,
  "pool": "pool1qzlwlpcsgflr9z3f24fg836tyq45p0kf5cnrp20s8v0psp6tdkx"
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/pool/blocks/{epoch}/{pool_hash}

URL Parameters

Parameter Description
epoch The Cardano epoch
pool_id The BECH 32 Pool id

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the block)
count 10 The number of results you will receive

getBlocksPerEpoch

This query returns information on how many blocks a pool created per epoch

curl --request GET \
     --url `https://api.blockrockz.io/cardano/v1/api/pool/blocks-epoch/{pool_hash}` \
     --header 'X-API-Key: test' \
     --header 'accept: application/json'

import requests

url = "https://api.blockrockz.io/cardano/v1/api/pool/blocks-epoch/{pool_hash}"

headers = {
    "accept": "application/json",
    "X-API-Key": "test"
}

response = requests.get(url, headers=headers)

fetch("https://api.blockrockz.io/cardano/v1/api/pool/blocks-epoch/{pool_hash}", {
  method: "GET"
  headers = {"accept": "application/json", "X-API-Key": "test"}
})
  .then((response) => {
    return response.json();
  })
  .then((json) => {
    console.log(json);
  });

The above command returns JSON structured like this:

{
  "block_count": 33,
  "epoch_no": 237
},
{
  "block_count": 24,
  "epoch_no": 290
},
{
  "block_count": 27,
  "epoch_no": 294
}

HTTP Request

GET https://api.blockrockz.io/cardano/v1/api/pool/blocks-epoch/{pool_hash}

URL Parameters

Parameter Description
pool_id The BECH 32 Pool id

Query Parameters

Parameter Default Description
order ASC The order in which the results are displayed (regarding the epoch)
count 10 The number of results you will receive
shell python javascript