API Tezos Nodes


Tezos Nodes API is used to integrate information resources into any project that will add value to Tezos. The API is intended for developers and is accompanied by detailed documentation. Before using the API, please notify us by e-mail [email protected].

For get information use base URL:


https://api.tezos-nodes.com/v1/

Get all Bakers


Request example:

https://api.tezos-nodes.com/v1/bakers

Returns information about the all Bakers and the important criteria by which to assess Bakers in rating:

Parameter Description
Rank Rank number
Logo A processed Baker logo that is adapted for dark and light colors themes
Name Baker name
Address Delegation address
Fee Charges to run node service
Life time in cycles The number of node operation cycles
Yield Yearly profit taking into account efficiency and fee
Efficiency The effectiveness of the node since it's launch
Efficiency for last 10 cycles The effectiveness of the node over the past 10 cycles
Free space Free space for delegation
Total reliability points The number of reliability points according to the personal Bakers assessment system

Example of a Baker object:

{
    "rank": 1,
    "logo": "https://tezos-nodes.com/images/CryptoDelegate.png",
    "name": "CryptoDelegate LLC",
    "address": "tz1Tnjaxk6tbAeC2TmMApPh8UsrEVQvhHvx5",
    "fee": 0.138,
    "lifetime": 204,
    "yield": 5.47,
    "efficiency": 100.65,
    "efficiency_last10cycle": 101.21,
    "freespace": 2857538,
    "reliability_points": 75
}

Get personal data about Baker


Request example:

https://api.tezos-nodes.com/v1/baker/{address}

Returns personal information about a particular Baker:

Parameter Description
Logo A processed Baker logo that is adapted for dark and light colors themes
Name Baker name
Address Delegation address
Fee Charges to run node service
All public contacts Baker The number of node operation cycles
Life time in cycles The number of node operation cycles
Yield Yearly profit taking into account efficiency and fee
Efficiency The effectiveness of the node since it's launch
Efficiency for last 10 cycles The effectiveness of the node over the past 10 cycles
Support Type of delegate support
Projects Availability of personal projects
Payouts Information about payout period
Voting Information about Baker voting history
Free space Free space for delegation
Delegation status Information about accepting new delegations
Total reliability points The number of reliability points according to the personal Bakers assessment system
PRO status Sponsorship Tezos-Nodes.com
Staking balance Number of tokens XTZ delegated to the Baker
Evaluated Balance The balance of the Baker, taking into account the frozen funds and planned to be received
Min delegations amount Minimum amount for delegation
Last endorsement Last endorsement time
Last baking Last baking block time
Next endorsement Next endorsement time
Next baking Next baking block time

Example of a Baker object:

{
    "logo": "https://tezos-nodes.com/images/Tezos_Capital_Legacy.png",
    "name": "Tezos Capital Legacy",
    "address": "tz1TDSmoZXwVevLTEvKCTHWpomG76oC9S2fJ",
    "fee": 0.15,
    "contacts": {
        "reddit": {
            "title": "Reddit",
            "url": "https://www.reddit.com/user/jonaslamis/",
            "icon": "https://tezos-nodes.com/icons/Reddit.svg"
        },
        "twitter": {
            "title": "Twitter",
            "url": "https://twitter.com/TezosCommunity",
            "icon": "https://tezos-nodes.com/icons/Twitter.svg"
        },
        "website": {
            "title": "Website",
            "url": "https://www.tezos.capital",
            "icon": "https://tezos-nodes.com/icons/Website.svg"
        }
    },
    "lifetime": 204,
    "yield": 5.36,
    "efficiency": 99.89,
    "efficiency_last10cycle": 101.55,
    "support": {
        "url": "https://twitter.com/TezosCommunity",
        "title": "Representative in social and media spaces",
        "icon": "https://tezos-nodes.com/icons/msg.svg"
    },
    "projects": [
        {
            "title": "Tezonomics audio podcast about Tezos blockchain",
            "url": "https://soundcloud.com/tezonomics",
            "icon": "https://tezos-nodes.com/icons/project.svg"
        }
    ],
    "payouts": {
        "title": "First rewards after 12 cycles",
        "icon": "https://tezos-nodes.com/icons/12.svg"
    },
    "voting": [
        {
            "proposal_name": "Athens A",
            "proposal_vote": "yay",
            "testing_vote": "yay",
            "promotion_vote": "yay"
        },
        {
            "proposal_name": "Brest",
            "proposal_vote": null,
            "testing_vote": "nay",
            "promotion_vote": null
        },
        {
            "proposal_name": "Babylon 2.0",
            "proposal_vote": "yay",
            "testing_vote": "yay",
            "promotion_vote": "yay"
        },
        {
            "proposal_name": "Carthage 2.0",
            "proposal_vote": null,
            "testing_vote": "yay",
            "promotion_vote": "yay"
        }
    ],
    "freespace": 8963047,
    "deletation_status": true,
    "total_points": 70,
    "pro_status": true,
    "staking_balance": 9364355,
    "evaluated_balance": 1803416,
    "min_delegations_amount": 0,
    "last_endoresment": "2020-03-11T10:41:17.00Z",
    "last_baking": "2020-03-11T10:19:57.00Z",
    "next_endoresment": "2020-03-11T10:44:17.00Z",
    "next_baking": "2020-03-11T10:50:17.00Z"
}