Reporting API

Everyone loves seeing the additional crypto they are earning. Staked provides an API for full access to the details.

Get Balance Of All Provisioned Nodes

GET https://mainnet.staked.cloud/api/reports/:chain/balance

Get the balance of all nodes provisioned through the Node Provisioning API.

Path Parameters

Name

Type

Description

chain*

String

Chain Name

Request Headers

Name

Type

Description

X-Api-Key*

string

Your API key (preferred method of passing api key is now in headers rather than query params)

Query Parameters

Name

Type

Description

api_key*

String

[Deprecated since March '25 (preferred method of passing api key is now in headers rather than query params)]

Your API key

{
    "total_balance": 32000000000000000000,
    "balances": [
        { // active validator
            "balance": 32000000000000000000,
            "block": 62421,
            "timestamp": "2021-09-15T22:25:25.737607",
            "address": "validator public key",
            "currency": "ETH2.0",
            "conversion_factor_power": 18,
            "attributes": {
                "status": "ACTIVE",
            }
        },
        { // validator provisioned but not deposited into
            "balance": null,
            "block": null,
            "timestamp": "2021-09-15T22:25:25.737607",
            "address": "validator public key",
            "currency": "ETH2.0",
            "conversion_factor_power": 18,
            "attributes": {}
        }
    ]
}

Get Balance Of Address

GET https://mainnet.staked.cloud/api/reports/:chain/delegator/:address/balance

Get the balance of an address that has delegated to Staked.

Path Parameters

Name

Type

Description

chain*

string

Chain Name

address*

string

Address to get balance for

Request Headers

Name

Type

Description

X-Api-Key*

string

Your API key (preferred method of passing api key is now in headers rather than query params)

Query Parameters

Name

Type

Description

api_key*

string

[Deprecated since March '25 (preferred method of passing api key is now in headers rather than query params)]

Your API key

{
  "balance": 5000000,
  "timestamp": "2019-07-08T17:09:08.753866",
  "address": "KT1W4Rda7pHrqmbDk4xDZ97YpgqAVHE5hndr"
}

Balance Object Schema

Field

Description

Type

balance

Staking balance

Number

block

Block of latest snapshot

Number

timestamp

Timestamp at latest snapshot

String

address

Address queried

String

conversion_factor_power

Decimals used in Number values (used to keep precision)

Number

attributes

Extra information depending on the chain

Object

import axios from "axios";

const api_key = 'YOUR API KEY';
const chain = 'TEZOS';
const address = 'KT1W4Rda7pHrqmbDk4xDZ97YpgqAVHE5hndr';

var api = axios.create({
  baseURL: "https://mainnet.staked.cloud/api",
  timeout: 1000000,
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": api_key
  }
});

api.get(`/reports/${chain}/delegator/${address}/balance`).then(response => {
  console.log(res);
})

const api_key = 'YOUR API KEY';
const chain = 'TEZOS';
const address = 'KT1W4Rda7pHrqmbDk4xDZ97YpgqAVHE5hndr';

var request = {
  "url": `https://mainnet.staked.cloud/api/reports/${chain}/delegator/${address}/balance`,
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "X-Api-Key": api_key
  }
};

$.ajax(request).done(function (response) {
  console.log(response);
});

var http = require('http');

const api_key = 'YOUR API KEY';
const chain = 'TEZOS';
const address = 'KT1W4Rda7pHrqmbDk4xDZ97YpgqAVHE5hndr';

var options = {
  'method': 'GET',
  'hostname': 'mainnet.staked.cloud',
  'path': `/api/reports/${chain}/delegator/${address}/balance`,
  'headers': {
    'Content-Type': 'application/json',
    'X-Api-Key': api_key
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

req.end();

import Alamofire

let api_key = 'YOUR API KEY';
let chain = 'TEZOS';
let address = 'KT1W4Rda7pHrqmbDk4xDZ97YpgqAVHE5hndr';

let headers: HTTPHeaders = [
    "Content-Type": "application/json",
    "X-Api-Key": api_key
]

AF.request("https://mainnet.staked.cloud/api/reports/\(chain)/delegator/\(address)/balance", headers: headers).response { response in
    debugPrint(response)
}

Get Detailed Balance of Address

GET https://mainnet.staked.cloud/api/reports/:chain/delegator/:address/detailed_balance

Get the detailed balance (summary view of rewards and the staked balance) of an address. The detail param is used to describe the results - "monthly" returns an array of detailed balance objects aggregated by month, "by_period" returns an array of detailed balance objects for each state change (delegation or reward).

Path Parameters

Name

Type

Description

chain*

string

Chain Name

address*

string

Address to get detailed balance for

Request Headers

Name

Type

Description

X-Api-Key*

string

Your API key (preferred method of passing api key is now in headers rather than query params)

Query Parameters

Name

Type

Description

api_key*

string

[Deprecated since March '25 (preferred method of passing api key is now in headers rather than query params)]

Your API Key

detail

string

"by_period" or "monthly"

{
    "results": [
        {
            "timestamp": "2020-08-27T14:12:31.722731",
            "block": null,
            "total_delegation": 3874585409425.0,
            "delegation": 3876252281981.0,
            "balance": 3897899084922.0,
            "total_reward_and_fees": 23313675497.0,
            "reward_and_fees": 23313675497.0,
            "total_reward": 23304218223.0,
            "reward": 23304218223.0,
            "total_fees": 9457274.0,
            "fees": 9457274.0,
            "total_gross_return": 0.006681130527750926,
            "gross_return": 0.006681130527750926,
            "annualized_gross_return": 0.016456788919817385,
            "block_explorer_url": null,
            "kind": null,
            "conversion_factor_power": 6,
            "currency": "Tezos"
        }
    ],
    "page": 1,
    "pages": 1,
    "per_page": 10,
    "total": 1
}

Response Object Schema

Field

Description

Type

results

Array of Detailed Balance Objects

Array

page

Current page of results

Number

pages

Total number of pages

Number

per_page

Results per page

Number

total

Total number of results

Number

Detailed Balance Object Schema

Detailed balance objects are returned for every state change of an account (stake, reward, unstake).

Field

Description

Type

timestamp

Timestamp of snapshot

String

block

Block of snapshot

Number

total_delegation

Total amount delegated

Number

delegation

Delegated amount in state change

Number

balance

Staking balance at snapshot

Number

total_reward_and_fees

Total accumulated reward and fees up to snapshot

Number

reward_and_fees

Reward and fees earned in state change

Number

total_reward

Total accumulated reward up to snapshot

Number

reward

Reward earned in state change

Number

total_fees

Total fees accumulated up to snapshot

Number

fees

Fees in state change

Number

total_gross_return

Total gross return up to snapshot

Number

gross_return

Gross return from state change

Number

annualized_gross_return

Annualized gross return

Number

block_explorer_url

Block Explorer URL for state change

String

kind

Kind of state change ("Delegation" or "Reward")

String

conversion_factor_power

Decimals used in Number values (used to keep precision)

Number

currency

Name of currency

String

Get Transactions (and rewards) of All Provisioned Nodes

GET https://mainnet.staked.cloud/api/reports/:chain/txns

Get the transactions for all nodes provisioned through the Staked API associated with your API key. Use the kind parameter to specify which type of transactions to query.

Path Parameters

Name

Type

Description

chain*

String

Chain Name

Request Headers

Name

Type

Description

X-Api-Key*

string

Your API key (preferred method of passing api key is now in headers rather than query params)

Query Parameters

Name

Type

Description

api_key*

String

[Deprecated since March '25 (preferred method of passing api key is now in headers rather than query params)]

Your API Key

kind

String

Transaction kind

start

String

Start date. Format: YYYY-MM-DD

end

String

End date. Format: YYYY-MM-DD

page

String

Page number for paginated results.

per_page

String

Number of items per page for paginated results.

[
    {
        "id": id,
        "kind": Transaction Kind,
        "transaction_time": Transaction Time,
        "transaction_address": Transaction Address,
        "holding_address": Holding Address,
        "amount": Amount,
        "reward": Reward,
        "fees": Fees,
        "total": Total,
        "denom": Denomination,
        "block_reference": Block Reference
    }
]

Get Transactions (and rewards) of Address

GET https://mainnet.staked.cloud/api/reports/:chain/delegator/:address/txns

Get the transactions for an address that has delegated to Staked. Use the kind parameter to specify which type of transactions to query.

Path Parameters

Name

Type

Description

chain*

string

Chain Name

address*

string

Address to get transaction data for

Request Headers

Name

Type

Description

X-Api-Key*

string

Your API key (preferred method of passing api key is now in headers rather than query params)

Query Parameters

Name

Type

Description

api_key*

string

[Deprecated since March '25 (preferred method of passing api key is now in headers rather than query params)]

Your API Key

kind

string

Transaction kind

start

string

Start date. Format: YYYY-MM-DD

end

string

End date. Format: YYYY-MM-DD

[
    {
        "id": id,
        "kind": Transaction Kind,
        "transaction_time": Transaction Time,
        "transaction_address": Transaction Address,
        "holding_address": Holding Address,
        "amount": Amount,
        "reward": Reward,
        "fees": Fees,
        "total": Total,
        "denom": Denomination,
        "block_reference": Block Reference
    }
]

Transaction Object Schema

Field

Description

Type

Transaction identifier

String

kind

Kind of transaction

Transaction Kind Enum

transaction_time

Timestamp of transaction

String

transaction_address

Hash or identifier of transaction on blockchain

String

holding_address

Address queried

String

Amount

Amount of value in transaction

Number

Reward

Reward in transaction

Number

Fees

Fees in transaction

Number

Total

Net value in transaction

Number

conversion_factor_power

Decimals used in Number values (used to keep precision)

Number

denom

Denomination

Number

block_reference

Block the transaction was included in

Number

Transaction Kind Enum

Value

Meaning

STK

Delegation Transactions

UNSTK

Undelegation Transactions

SCH

Scheduled Future Rewards

PEND

Rewards in Frozen Period

PYBL

Rewards Pending Distribution

PAID

Earned Rewards

XFER

Transfers (includes withdrawals in Ethereum)

Last updated 7 months ago

hashtagGet Balance Of All Provisioned Nodes

hashtagPath Parameters

hashtagRequest Headers

hashtagQuery Parameters

hashtagGet Balance Of Address

hashtagPath Parameters

hashtagRequest Headers

hashtagQuery Parameters

hashtagGet Detailed Balance of Address

hashtagPath Parameters

hashtagRequest Headers

hashtagQuery Parameters

hashtagGet Transactions (and rewards) of All Provisioned Nodes

hashtagPath Parameters

hashtagRequest Headers

hashtagQuery Parameters

hashtagGet Transactions (and rewards) of Address

hashtagPath Parameters

hashtagRequest Headers

hashtagQuery Parameters

Get Balance Of All Provisioned Nodes

Path Parameters

Request Headers

Query Parameters

Get Balance Of Address

Path Parameters

Request Headers

Query Parameters

Get Detailed Balance of Address

Path Parameters

Request Headers

Query Parameters

Get Transactions (and rewards) of All Provisioned Nodes

Path Parameters

Request Headers

Query Parameters

Get Transactions (and rewards) of Address

Path Parameters

Request Headers

Query Parameters