Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NEAR Protocol Validators API

The Validators API from NEAR Protocol — 1 operation(s) for validators.

NEAR Protocol Validators API is one of 60 APIs that NEAR Protocol publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Validators. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 1 operation across 1 path, and defines 21 schemas. It is described by OpenAPI 3.0.3, at version 3.0.3.

Requests are made against 2 base URLs: https://api.fastnear.com, https://test.api.fastnear.com.

1 operations 1 paths 21 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0.3
Base URL
https://rpc.mainnet.near.org
Resource Areas
1

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Validators 1
POST
/validators
Queries active validators on the network. Returns details and the state of validation on the blockchain.
validators body → 200

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are CurrentEpochValidatorInfo (16 properties), RpcValidatorResponse (9 properties), JsonRpcRequest_for_validators (4 properties), NextEpochValidatorInfo (4 properties). Each schema is shown below with its type and property counts.

NearToken
string
ValidatorStakeViewV1
object
3 properties 3 required
RpcValidatorResponse
object
Information about this epoch validators and next epoch validators
9 properties 8 required
EpochId
Epoch identifier -- wrapped hash, to make it easier to distinguish. EpochId of epoch T is the hash of last block in T-2 EpochId of first two epochs is 0
JsonRpcResponse_for_RpcValidatorResponse_and_RpcValidatorError
object
2 properties 2 required
RpcValidatorRequest
object
ValidatorKickoutReason
Reasons for removing a validator from the validator set.
ValidatorKickoutView
object
2 properties 2 required
AccountId
string
NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for informatio…
JsonRpcRequest_for_validators
object
4 properties 4 required
ValidatorStakeView
InternalError
ErrorWrapper_for_RpcValidatorError
ShardId
integer
The shard identifier. It may be an arbitrary number - it does not need to be a number in the range 0..NUMSHARDS. The shard ids do not need to be sequential or…
CurrentEpochValidatorInfo
object
Describes information about the current epoch validator
16 properties 7 required
PublicKey
string
RpcValidatorError
CryptoHash
string
BlockId
NextEpochValidatorInfo
object
4 properties 4 required
RpcRequestValidationErrorKind

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

near-validators-api-openapi.yml Raw ↑

Other APIs NEAR Protocol publishes across the network.

NEAR Protocol accounts API
NEAR Protocol Block API
NEAR Protocol Block Effects API
NEAR Protocol Broadcast Tx Async API
NEAR Protocol Broadcast Tx Commit API
NEAR Protocol Changes API
NEAR Protocol Chunk API
NEAR Protocol Client Config API
NEAR Protocol EXPERIMENTAL Call Function API
NEAR Protocol EXPERIMENTAL Changes API
NEAR Protocol EXPERIMENTAL Changes In Block API
NEAR Protocol EXPERIMENTAL Congestion Level API