Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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.
openapi: 3.2.0
info:
title: FastNEAR RPC Metrics 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: Metrics
paths:
/metrics:
get:
operationId: metrics
summary: Get node metrics
description: Retrieves Prometheus-format node metrics from the HTTP `/metrics` endpoint. Requires an API key.
responses:
'200':
description: Successful response
content:
text/plain:
schema:
type: string
description: Prometheus exposition text
example: '# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.
# TYPE process_cpu_seconds_total counter
process_cpu_seconds_total 12.34'
'403':
description: Missing or invalid API key
content:
text/plain:
schema:
type: string
example: Forbidden
tags:
- Metrics
components:
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.