FastNEAR Validators By Epoch API
The Validators By Epoch API from FastNEAR — 1 operation(s) for validators by epoch.
The Validators By Epoch API from FastNEAR — 1 operation(s) for validators by epoch.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fastnear:fastnear-validators-by-epoch-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: FastNEAR RPC Validators By Epoch API
description: 'NEAR Protocol JSON RPC
Send your FastNEAR API key as an `Authorization: Bearer` header (preferred) or an `apiKey` query parameter. An unrecognized key is rejected with 403.
For exhaustive list of endpoints, refer to the NEAR documentation.'
version: 1.0.0
servers:
- url: https://rpc.mainnet.fastnear.com
description: Mainnet
- url: https://rpc.testnet.fastnear.com
description: Testnet
- url: https://archival-rpc.mainnet.fastnear.com
description: Mainnet Archival
- url: https://archival-rpc.testnet.fastnear.com
description: Testnet Archival
security:
- {}
- BearerAuth: []
- ApiKeyAuth: []
tags:
- name: Validators By Epoch
paths:
/validators_by_epoch:
post:
operationId: validators_by_epoch
summary: Get validators by epoch
description: Fetch the validator set for a chosen past epoch, selected by epoch-start block height or Base58 epoch-id hash.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
type: string
example: fastnear
method:
type: string
enum:
- validators
params:
type: object
required:
- epoch_id
properties:
epoch_id:
type: string
description: Base58-encoded epoch identifier hash
examples:
mainnet:
summary: Get validators by epoch (Mainnet)
value:
jsonrpc: '2.0'
id: fastnear
method: validators
params:
epoch_id: 4cPDvNDzf3zbKvAxPNWnNGGz8x2tty6xhowmsugAm3fo
testnet:
summary: Get validators by epoch (Testnet)
value:
jsonrpc: '2.0'
id: fastnear
method: validators
params:
epoch_id: BARiarhzfSL7G737ik4AukX9sFYH1iR3dYU3KNUAvF3e
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcResponse_validators_by_epoch'
'403':
description: The supplied API key was not recognized.
content:
text/plain:
schema:
type: string
example: Invalid API key
tags:
- Validators By Epoch
components:
schemas:
JsonRpcResponse_validators_by_epoch:
type: object
required:
- jsonrpc
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
oneOf:
- type: string
- type: number
result:
type: object
description: Information about this epoch validators and next epoch validators
properties:
current_fishermen:
type: array
items:
type: object
description: One of multiple possible types
description: Fishermen for the current epoch
current_proposals:
type: array
items:
type: object
description: One of multiple possible types
description: Proposals in the current epoch
current_validators:
type: array
items:
type: object
description: Describes information about the current epoch validator
description: Validators for the current epoch
epoch_height:
type: integer
description: Epoch height
format: uint64
minimum: 0
epoch_start_height:
type: integer
description: Epoch start block height
format: uint64
minimum: 0
next_fishermen:
type: array
items:
type: object
description: One of multiple possible types
description: Fishermen for the next epoch
next_validators:
type: array
items:
type: object
description: Validators for the next epoch
prev_epoch_kickout:
type: array
items:
type: object
description: Kickout in the previous epoch
validator_reward_paid_prev_epoch:
type: object
description: 'Per-validator rewards paid out at the start of the previous epoch.
For epoch E, this contains the rewards earned in epoch E-2 that were
added to validator and treasury balances at the first block of epoch
E-1 (via `ValidatorAccountsUpdate`).'
required:
- current_validators
- next_validators
- current_fishermen
- next_fishermen
- current_proposals
- prev_epoch_kickout
- epoch_start_height
- epoch_height
error:
type: object
properties:
code:
type: integer
message:
type: string
data:
type: object
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'FastNEAR API key as an `Authorization: Bearer` header. Preferred for backends, workers, and proxies because it keeps the key out of URLs and logs.'
ApiKeyAuth:
type: apiKey
in: query
name: apiKey
description: FastNEAR API key as the `apiKey` query parameter. Handy for curl or clients that cannot set headers, but the key can end up in URLs, logs, and shell history.