FastNEAR Public Key API
The public-key API from FastNEAR — 4 operation(s) for public-key.
The public-key API from FastNEAR — 4 operation(s) for public-key.
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-public-key-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:
description: 'Low-latency indexed account, token, and public-key lookup APIs for wallets and explorers. Send your FastNEAR API key as an `Authorization: Bearer` header (preferred) or an `apiKey` query parameter. An unrecognized key is rejected with 403.'
title: FastNEAR Public Key API
version: 3.0.3
servers:
- description: Mainnet
url: https://api.fastnear.com
- description: Testnet
url: https://test.api.fastnear.com
security:
- {}
- BearerAuth: []
- ApiKeyAuth: []
tags:
- name: Public Key
paths:
/v0/public_key/{public_key}:
get:
description: Fetch the account IDs that have registered a full-access public key, via the legacy V0 lookup path.
operationId: lookup_by_public_key_v0
parameters:
- description: NEAR public key or access-key handle in `ed25519:...`, `secp256k1:...`, `ml-dsa-65:...`, or `ml-dsa-65-hash:...` form.
example: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
in: path
name: public_key
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
account_ids:
- root.near
public_key: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
schema:
$ref: '#/components/schemas/PublicKeyLookupResponse'
description: Matching account IDs for the supplied full-access public key or access-key handle
'400':
content:
application/json:
schema:
type: string
description: Bad Request
'403':
content:
text/plain:
example: Invalid API key
schema:
type: string
description: The supplied API key was not recognized.
'500':
content:
application/json:
schema:
type: string
description: Internal Server Error
summary: Lookup full-access accounts by public key
tags:
- Public Key
x-fastnear-slug: public_key_lookup
x-fastnear-title: FastNEAR API - V0 Public Key Lookup
/v0/public_key/{public_key}/all:
get:
description: List every account tied to a public key — full-access and limited-access keys together — via the legacy V0 lookup-all path.
operationId: lookup_by_public_key_all_v0
parameters:
- description: NEAR public key or access-key handle in `ed25519:...`, `secp256k1:...`, `ml-dsa-65:...`, or `ml-dsa-65-hash:...` form.
example: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
in: path
name: public_key
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
account_ids:
- root.near
public_key: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
schema:
$ref: '#/components/schemas/PublicKeyLookupResponse'
description: Matching account IDs for the supplied public key or access-key handle, including limited-access keys
'400':
content:
application/json:
schema:
type: string
description: Bad Request
'403':
content:
text/plain:
example: Invalid API key
schema:
type: string
description: The supplied API key was not recognized.
'500':
content:
application/json:
schema:
type: string
description: Internal Server Error
summary: Lookup all indexed accounts by public key
tags:
- Public Key
x-fastnear-slug: public_key_lookup_all
x-fastnear-title: FastNEAR API - V0 Public Key Lookup (All)
/v1/public_key/{public_key}:
get:
description: Resolve a full-access public key to the indexed NEAR accounts that have registered it — V1 canonical lookup path.
operationId: lookup_by_public_key_v1
parameters:
- description: NEAR public key or access-key handle in `ed25519:...`, `secp256k1:...`, `ml-dsa-65:...`, or `ml-dsa-65-hash:...` form.
example: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
in: path
name: public_key
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
account_ids:
- root.near
public_key: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
schema:
$ref: '#/components/schemas/PublicKeyLookupResponse'
description: Matching account IDs for the supplied full-access public key or access-key handle
'400':
content:
application/json:
schema:
type: string
description: Bad Request
'403':
content:
text/plain:
example: Invalid API key
schema:
type: string
description: The supplied API key was not recognized.
'500':
content:
application/json:
schema:
type: string
description: Internal Server Error
summary: Lookup full-access accounts by public key
tags:
- Public Key
x-fastnear-slug: public_key_lookup
x-fastnear-title: FastNEAR API - V1 Public Key Lookup
/v1/public_key/{public_key}/all:
get:
description: Resolve a public key to every account that holds it — full-access and limited-access keys alike — via the V1 lookup-all path.
operationId: lookup_by_public_key_all_v1
parameters:
- description: NEAR public key or access-key handle in `ed25519:...`, `secp256k1:...`, `ml-dsa-65:...`, or `ml-dsa-65-hash:...` form.
example: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
in: path
name: public_key
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
account_ids:
- root.near
public_key: ed25519:CCaThr3uokqnUs6Z5vVnaDcJdrfuTpYJHJWcAGubDjT
schema:
$ref: '#/components/schemas/PublicKeyLookupResponse'
description: Matching account IDs for the supplied public key or access-key handle, including limited-access keys
'400':
content:
application/json:
schema:
type: string
description: Bad Request
'403':
content:
text/plain:
example: Invalid API key
schema:
type: string
description: The supplied API key was not recognized.
'500':
content:
application/json:
schema:
type: string
description: Internal Server Error
summary: Lookup all indexed accounts by public key
tags:
- Public Key
x-fastnear-slug: public_key_lookup_all
x-fastnear-title: FastNEAR API - V1 Public Key Lookup (All)
components:
schemas:
PublicKeyLookupResponse:
additionalProperties: false
properties:
account_ids:
items:
type: string
type: array
public_key:
type: string
required:
- public_key
- account_ids
type: object
securitySchemes:
ApiKeyAuth:
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.
in: query
name: apiKey
type: apiKey
BearerAuth:
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.'
scheme: bearer
type: http