Peers

Get information about the peers of the node.

Get information about the peers of the node.

get

/api/core/v2/peers

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://iota.nownodes.io/api/core/v2/peers'

200

403

500

200

[
  {
    "id": "12D3KooWMajsSUxSUFb3CRgmJvygYCGd27uMDdppVYNGud7xuKG5",
    "multiAddresses": [
      "/dns/abc.com/tcp/15602"
    ],
    "alias": "abc",
    "relation": "known",
    "connected": true,
    "gossip": {
      "heartbeat": {
        "solidMilestoneIndex": 61527,
        "prunedMilestoneIndex": 61200,
        "latestMilestoneIndex": 61527,
        "connectedNeighbors": 5,
        "syncedNeighbors": 7
      },
      "metrics": {
        "newBlocks": 3799,
        "knownBlocks": 554,
        "receivedBlocks": 4370,
        "receivedBlockRequests": 0,
        "receivedMilestoneRequests": 1,
        "receivedHeartbeats": 1,
        "sentBlocks": 6,
        "sentBlockRequests": 4325,
        "sentMilestoneRequests": 31,
        "sentHeartbeats": 9,
        "droppedPackets": 0
      }
    }
  },
  {
    "id": "12D3KooWNYDcJqxnWqCLSgeQKqNStwFUqHSJXPdSYTJnfxQESzie",
    "multiAddresses": [
      "/dns/xyz.com/tcp/15600"
    ],
    "alias": "xyz",
    "relation": "known",
    "connected": true,
    "gossip": {
      "heartbeat": {
        "solidMilestoneIndex": 61527,
        "prunedMilestoneIndex": 56508,
        "latestMilestoneIndex": 61527,
        "connectedNeighbors": 5,
        "syncedNeighbors": 6
      },
      "metrics": {
        "newBlocks": 510,
        "knownBlocks": 79,
        "receivedBlocks": 589,
        "receivedBlockRequests": 0,
        "receivedMilestoneRequests": 1,
        "receivedHeartbeats": 1,
        "sentBlocks": 42,
        "sentBlockRequests": 576,
        "sentMilestoneRequests": 1,
        "sentHeartbeats": 9,
        "droppedPackets": 0
      }
    }
  }
]

Successful operation.

Add a given peer to the node.

Add a given peer to the node.

post

/api/core/v2/peers

Body

multiAddressstringrequired

aliasstring

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://iota.nownodes.io/api/core/v2/peers' \
  --header 'Content-Type: application/json' \
  --data '{"multiAddress":"/dns/abc.com/tcp/15602/p2p/12D3KooWMajsSUxSUFb3CRgmJvygYCGd27uMDdppVYNGud7xuKG5","alias":"abc.com"}'

200

403

404

500

200

{
  "id": "12D3KooWMajsSUxSUFb3CRgmJvygYCGd27uMDdppVYNGud7xuKG5",
  "multiAddresses": [
    "/dns/abc.com/tcp/15602"
  ],
  "alias": "abc",
  "relation": "known",
  "connected": true,
  "gossip": {
    "heartbeat": {
      "solidMilestoneIndex": 61527,
      "prunedMilestoneIndex": 61200,
      "latestMilestoneIndex": 61527,
      "connectedNeighbors": 5,
      "syncedNeighbors": 7
    },
    "metrics": {
      "newBlocks": 3799,
      "knownBlocks": 554,
      "receivedBlocks": 4370,
      "receivedBlockRequests": 0,
      "receivedMilestoneRequests": 1,
      "receivedHeartbeats": 1,
      "sentBlocks": 6,
      "sentBlockRequests": 4325,
      "sentMilestoneRequests": 31,
      "sentHeartbeats": 9,
      "droppedPackets": 0
    }
  }
}

Successful operation.

Get information about a given peer.

Get information about a given peer.

get

/api/core/v2/peers/{peerId}

Path parameters

peerIdstringrequired

Identifier of the block.

Example: 12D3KooWMajsSUxSUFb3CRgmJvygYCGd27uMDdppVYNGud7xuKG5

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://iota.nownodes.io/api/core/v2/peers/{peerId}'

200

400

403

404

500

200

{
  "id": "12D3KooWMajsSUxSUFb3CRgmJvygYCGd27uMDdppVYNGud7xuKG5",
  "multiAddresses": [
    "/dns/abc.com/tcp/15602"
  ],
  "alias": "abc",
  "relation": "known",
  "connected": true,
  "gossip": {
    "heartbeat": {
      "solidMilestoneIndex": 61527,
      "prunedMilestoneIndex": 61200,
      "latestMilestoneIndex": 61527,
      "connectedNeighbors": 5,
      "syncedNeighbors": 7
    },
    "metrics": {
      "newBlocks": 3799,
      "knownBlocks": 554,
      "receivedBlocks": 4370,
      "receivedBlockRequests": 0,
      "receivedMilestoneRequests": 1,
      "receivedHeartbeats": 1,
      "sentBlocks": 6,
      "sentBlockRequests": 4325,
      "sentMilestoneRequests": 31,
      "sentHeartbeats": 9,
      "droppedPackets": 0
    }
  }
}

Successful operation.