listEpochs

GET

/v1/explorer/epochs

const url = 'https://testnet-rpc.necter.network/v1/explorer/epochs?status=open&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/explorer/epochs?status=open&limit=50'

Parameters

Query Parameters

project_id

string

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

status

string

Allowed values: open closed attested submitted settled released vetoed underfunded

limit

integer

default: 50 >= 1 <= 200

cursor

string

Responses

200

Project epochs, newest first

application/json

object

items

required

array

next_cursor

required

string | null

items

required

Array<object>

object

project_id

required

string

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

epoch

required

integer

epoch_secs

integer

starts_at

integer

ends_at

integer

status

required

string

Allowed values: open closed attested submitted settled released vetoed underfunded

rounds

integer

fallback_rounds

integer

miners

integer

token

object

address

required

Lowercase EVM address

string

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

symbol

required

string

name

string

decimals

required

integer

<= 36

totals

object

units

required

integer

gross

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

miner

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

developer

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

treasury

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

receipt_hash

string

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

merkle_root

string

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

settlement

object

status

open: the epoch has no attested receipt yet (nothing to settle)

string

Allowed values: open queued signed sent settled released vetoed reverted failed

tx_hash

string

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

block_number

integer

claimable_at

integer

error

string | null

Example

{
  "items": [
    {
      "status": "open",
      "settlement": {
        "status": "open"
      }
    }
  ]
}