Network & Peers

Network topology and peer information

Endpoints for querying network peer information, validator nodes, and network topology data.

Get ANR by public key

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/anr/{publicKey}

Retrieves the Amadeus Node Record (ANR) for a specific peer by their public key. ANRs contain peer connection information, signatures, and metadata.

Path parameters

publicKeystringRequired

Base58-encoded public key of the peer

Example: 7EVUJfpnEqK32KrzUAaR4Yf26KgT66AWwW63xSHw5mbgdQhV8iwL1NkHMAqTi5Hv3h

Responses

200

ANR found successfully

application/json

404

ANR not found

application/json

get

/api/peer/anr/{publicKey}

cURLJavaScript

curl -X GET \
  "https://nodes.amadeus.bot/api/peer/anr/7EVUJfpnEqK32KrzUAaR4Yf26KgT66AWwW63xSHw5mbgdQhV8iwL1NkHMAqTi5Hv3h"

{
  "error": "ok",
  "anr": {
    "ip4": "192.168.1.100",
    "pk": "7EVUJfpnEqK32KrzUAaR4Yf26KgT66AWwW63xSHw5mbgdQhV8iwL1NkHMAqTi5Hv3h",
    "pop": "text",
    "port": 36969,
    "signature": "text",
    "ts": 1,
    "version": "1.1.9",
    "anr_name": "text",
    "anr_desc": "text"
  }
}

Get validator ANRs

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/anr_validators

Retrieves ANRs for all current validator nodes in the network

Responses

200

Validator ANRs retrieved successfully

application/json

get

/api/peer/anr_validators

cURL

curl -X GET "https://nodes.amadeus.bot/api/peer/anr_validators"

200

Validator ANRs retrieved successfully

{
  "error": "ok",
  "anrs": [
    {
      "ip4": "192.168.1.100",
      "pk": "7EVUJfpnEqK32KrzUAaR4Yf26KgT66AWwW63xSHw5mbgdQhV8iwL1NkHMAqTi5Hv3h",
      "pop": "text",
      "port": 36969,
      "signature": "text",
      "ts": 1,
      "version": "1.1.9",
      "anr_name": "text",
      "anr_desc": "text"
    }
  ]
}

Get all ANRs

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/anr

Retrieves ANRs for all known peers in the network

Responses

200

All ANRs retrieved successfully

application/json

get

/api/peer/anr

HTTPcURLJavaScriptPython

GET /api/peer/anr HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

All ANRs retrieved successfully

{
  "error": "ok",
  "anrs": [
    {
      "ip4": "192.168.1.100",
      "pk": "7EVUJfpnEqK32KrzUAaR4Yf26KgT66AWwW63xSHw5mbgdQhV8iwL1NkHMAqTi5Hv3h",
      "pop": "text",
      "port": 36969,
      "signature": "text",
      "ts": 1,
      "version": "1.1.9",
      "anr_name": "text",
      "anr_desc": "text"
    }
  ]
}

Get all nodes for web display

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/nodes

Retrieves formatted node information suitable for web interfaces

Responses

200

Nodes retrieved successfully

application/json

get

/api/peer/nodes

HTTPcURLJavaScriptPython

GET /api/peer/nodes HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Nodes retrieved successfully

{
  "error": "ok",
  "nodes": [
    {
      "pk": "text",
      "ip4": "text",
      "version": "text",
      "latency": 1,
      "last_message": 1,
      "online": true
    }
  ]
}

Get trainer nodes

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/trainers

Retrieves information about all trainer/validator nodes

Responses

200

Trainers retrieved successfully

application/json

get

/api/peer/trainers

HTTPcURLJavaScriptPython

GET /api/peer/trainers HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Trainers retrieved successfully

{
  "error": "ok",
  "trainers": [
    "text"
  ]
}

Get removed trainers

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/peer/removed_trainers

Retrieves information about trainers that have been removed from the network

Responses

200

Removed trainers retrieved successfully

application/json

get

/api/peer/removed_trainers

HTTPcURLJavaScriptPython

GET /api/peer/removed_trainers HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Removed trainers retrieved successfully

{
  "error": "ok",
  "trainers": [
    "text"
  ]
}