Babylon System API (0.2.0)

Download OpenAPI specification:Download

This API is exposed by the Babylon Radix node to give clients access to information about the node itself, its configuration, status and subsystems.

It is intended for use by node-runners on a private network, and is not intended to be exposed publicly. Heavy load may impact the node's function.

If you require queries against ledger state, you may also wish to consider using the Core API or Gateway API instead.

Get Version

Responses
200

Version

default

Unexpected error

get/version
Response samples
application/json
{
  • "version": "string"
}

Get Node Identity

Responses
200

Node Identity

default

Unexpected error

get/identity
Response samples
application/json
{
  • "public_key_hex": "stringstringstringstringstringstringstringstringstringstringstring",
  • "node_address": "string",
  • "node_uri": "string",
  • "node_name": "string",
  • "node_id": "string",
  • "validator_address": "string",
  • "validator_name": "string",
  • "consensus_status": "VALIDATING_IN_CURRENT_EPOCH"
}

Get Health

Responses
200

Health

default

Unexpected error

get/health
Response samples
application/json
{
  • "status": "BOOTING",
  • "current_fork_name": "string",
  • "executed_forks": [
    ],
  • "fork_vote_status": "VOTE_REQUIRED",
  • "unknown_reported_forks": [
    ]
}

Get Configuration

Responses
200

System Configuration

default

Unexpected error

get/configuration
Response samples
application/json
{
  • "mempool": {
    },
  • "bft": {
    },
  • "sync": {
    },
  • "networking": {
    }
}

Get Peers

Responses
200

Peers

default

Unexpected error

get/peers
Response samples
application/json
{
  • "peers": [
    ]
}

Get Address Book

Responses
200

Address Book

default

Unexpected error

get/addressbook
Response samples
application/json
{
  • "entries": [
    ]
}

Get Network Sync Status

Returns the current sync status of the node.

Responses
200

Network Status

default

Unexpected error

get/network-sync-status
Response samples
application/json
{
  • "sync_status": {
    }
}