FastNEAR EXPERIMENTAL Protocol Config API
The EXPERIMENTAL Protocol Config API from FastNEAR — 1 operation(s) for experimental protocol config.
The EXPERIMENTAL Protocol Config API from FastNEAR — 1 operation(s) for experimental protocol config.
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-experimental-protocol-config-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 EXPERIMENTAL Protocol Config 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: EXPERIMENTAL Protocol Config
paths:
/EXPERIMENTAL_protocol_config:
post:
operationId: EXPERIMENTAL_protocol_config
summary: Get protocol config
description: Fetch the runtime protocol config at a chosen block — gas costs, storage prices, and limits currently in force.
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:
- EXPERIMENTAL_protocol_config
params:
type: object
description: One of multiple possible types
examples:
mainnet:
summary: Get protocol config (Mainnet)
value:
jsonrpc: '2.0'
id: fastnear
method: EXPERIMENTAL_protocol_config
params:
finality: final
testnet:
summary: Get protocol config (Testnet)
value:
jsonrpc: '2.0'
id: fastnear
method: EXPERIMENTAL_protocol_config
params:
finality: final
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcResponse_EXPERIMENTAL_protocol_config'
'403':
description: The supplied API key was not recognized.
content:
text/plain:
schema:
type: string
example: Invalid API key
tags:
- EXPERIMENTAL Protocol Config
components:
schemas:
JsonRpcResponse_EXPERIMENTAL_protocol_config:
type: object
required:
- jsonrpc
- id
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
oneOf:
- type: string
- type: number
result:
type: object
properties:
block_producer_kickout_threshold:
type: integer
description: Threshold for kicking out block producers, between 0 and 100.
format: uint8
minimum: 0
chain_id:
type: string
description: 'ID of the blockchain. This must be unique for every blockchain.
If your testnet blockchains do not have unique chain IDs, you will have a bad time.'
chunk_producer_kickout_threshold:
type: integer
description: Threshold for kicking out chunk producers, between 0 and 100.
format: uint8
minimum: 0
chunk_validator_only_kickout_threshold:
type: integer
description: Threshold for kicking out nodes which are only chunk validators, between 0 and 100.
format: uint8
minimum: 0
dynamic_resharding:
type: boolean
description: Enable dynamic re-sharding.
epoch_length:
type: integer
description: Epoch length counted in block heights.
format: uint64
minimum: 0
fishermen_threshold:
type: string
description: Amount in yoctoNEAR
gas_limit:
type: string
description: Gas amount
gas_price_adjustment_rate:
type: array
items:
type: integer
format: int32
description: Gas price adjustment rate
genesis_height:
type: integer
description: Height of genesis block.
format: uint64
minimum: 0
genesis_time:
type: string
description: Official time of blockchain start.
format: date-time
max_gas_price:
type: string
description: Amount in yoctoNEAR
max_inflation_rate:
type: array
items:
type: integer
format: int32
description: Maximum inflation on the total supply every epoch.
max_kickout_stake_perc:
type: integer
description: Max stake percentage of the validators we will kick out.
format: uint8
minimum: 0
min_gas_price:
type: string
description: Amount in yoctoNEAR
minimum_stake_divisor:
type: integer
description: The minimum stake required for staking is last seat price divided by this number.
format: uint64
minimum: 0
minimum_stake_ratio:
type: array
items:
type: integer
format: int32
description: 'The lowest ratio s/s_total any block producer can have.
See <https://github.com/near/NEPs/pull/167> for details'
minimum_validators_per_shard:
type: integer
description: The minimum number of validators each shard must have
format: uint64
minimum: 0
num_block_producer_seats:
type: integer
description: Number of block producer seats at genesis.
format: uint64
minimum: 0
num_blocks_per_year:
type: integer
description: Expected number of blocks per year
format: uint64
minimum: 0
online_max_threshold:
type: array
items:
type: integer
format: int32
description: Online maximum threshold above which validator gets full reward.
online_min_threshold:
type: array
items:
type: integer
format: int32
description: Online minimum threshold below which validator doesn't receive reward.
protocol_reward_rate:
type: array
items:
type: integer
format: int32
description: Protocol treasury rate
protocol_treasury_account:
type: string
description: NEAR account ID
protocol_upgrade_stake_threshold:
type: array
items:
type: integer
format: int32
description: Threshold of stake that needs to indicate that they ready for upgrade.
protocol_version:
type: integer
description: Current Protocol Version
format: uint32
minimum: 0
runtime_config:
type: object
description: View that preserves JSON format of the runtime config.
properties:
account_creation_charge:
type: string
description: Amount in yoctoNEAR
default: '0'
account_creation_config:
type: object
description: The structure describes configuration for creation of new accounts.
congestion_control_config:
type: object
description: The configuration for congestion control. More info about congestion [here](https://near.github.io/nearcore/architecture/how/receipt-congestion.html?highlight=congestion#receipt-congestion)
min_gas_purchase_price:
type: string
description: Amount in yoctoNEAR
default: '0'
storage_amount_per_byte:
type: string
description: Amount in yoctoNEAR
transaction_costs:
type: object
description: Describes different fees for the runtime
wasm_config:
type: object
description: Config of wasm operations.
witness_config:
type: object
description: Configuration specific to ChunkStateWitness.
shard_layout:
type: object
description: One of multiple possible types
shuffle_shard_assignment_for_chunk_producers:
type: boolean
description: 'If true, shuffle the chunk producers across shards. In other words, if
the shard assignments were `[S_0, S_1, S_2, S_3]` where `S_i` represents
the set of chunk producers for shard `i`, if this flag were true, the
shard assignments might become, for example, `[S_2, S_0, S_3, S_1]`.'
target_validator_mandates_per_shard:
type: integer
description: Number of target chunk validator mandates for each shard.
format: uint64
minimum: 0
transaction_validity_period:
type: integer
description: Number of blocks for which a given transaction is valid
format: uint64
minimum: 0
avg_hidden_validator_seats_per_shard:
type: array
items:
type: integer
format: uint64
minimum: 0
description: Expected number of hidden validators per shard.
num_block_producer_seats_per_shard:
type: array
items:
type: integer
format: uint64
minimum: 0
description: Defines number of shards and number of block producer seats per each shard at genesis.
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.