Public directory of bound devices (`endpoints.miners` of the network descriptor), newest first

GET

/v1/miners

const url = 'https://testnet-rpc.necter.network/v1/miners?limit=50';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://testnet-rpc.necter.network/v1/miners?limit=50'

Parameters

Query Parameters

limit

integer

default: 50 >= 1 <= 200

cursor

string

Responses

200

Devices (public view)

application/json

object

items

required

array

next_cursor

required

string | null

items

required

Array<object>

(owner sees all fields; public view omits hardware details and label)

object

node_id

required

string

/^ndsr-[0-9a-f]{16}$/

public_key

required

string

/^0x[0-9a-f]{64}$/

owner

One of:

string
null

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

binding_hash

One of:

string
null

string

/^0x[0-9a-f]{64}$/

label

string | null

group_id

string | null

class

string

Allowed values: phone tablet laptop desktop server

platform

string

Allowed values: android ios macos windows linux

os_version

string

arch

string

engine

string

Allowed values: native pulley64 pulley32

miner_version

string

ndsr_version

string

status

required

string

Allowed values: online idle offline faulty banned

status_reason

string | null

last_seen_at

integer

connected_since

One of:

integer
null

integer

hardware

object

cpu_model

string

cpu_cores

integer

cpu_threads

integer

ram_mb

integer

storage_free_mb

integer

gpu

One of:

null
object

null

network

string

Allowed values: wifi ethernet cellular none

battery

boolean

string

arch

string

benchmark

One of:

object
null

object

suite

required

string

ran_at

required

integer

engine

required

string

Allowed values: native pulley64 pulley32

cases

required

Array<object>

object

name

required

string

receipt_hash

required

string

/^0x[0-9a-f]{64}$/

gas_used

required

integer

elapsed_us

required

integer

mgas_per_s

required

Array<integer>

score

required

integer

attestation

null

subscriptions

Array<string>

region

string | null

uptime_bp_7d

integer

units_7d

integer

created_at

integer

Example

{
  "items": [
    {
      "class": "phone",
      "platform": "android",
      "engine": "native",
      "status": "online",
      "hardware": {
        "network": "wifi"
      },
      "benchmark": {
        "engine": "native"
      }
    }
  ]
}