• RPC Service
  • Getting Started

Getting Started

RPC Service — a platform that enables users to empower their Web3 projects with the blockchain interaction capabilities (22 blockchains supported) via the top-performing globally-distributed decentralized infrastructure of nodes.

RPC Overview

The platform has the following functionality to offer:

  • JSON-RPC API — the endpoints (either public or private) to integrate into your project for blockchain interaction.
  • Advanced APIs — collections of endpoints that supports simultaneous querying of multiple blockchains for the most popular Web3 scenarios at near-instant speeds; available via JavaScript/Python SDKs and React Hooks.
  • Usage statistics — the means to have a full view of your blockchain interaction statistics.
  • RPC methods testing — a tool for RPC methods testing.
  • Hybrid infrastructure — the access point for adding either private or external providers' nodes into Ankr's infrastructure.

Basics with Public plan

What's available for the Public plan user:

  • RPC Endpoints and Advanced APIs at the corresponding rate limits.
  • Connection code snippets.
  • RPC methods testing tool.
  • Public usage data (stats on requests from all Public service users).

Interface schema

Public Endpoints

Use public endpoints

To enable your project to interact with a blockchain, add the blockchain's endpoint into the project's library or config file:

  1. In Navigation, click Endpoints to open the pane.
  2. In the Chain Selection area, click a chain you'd like to query.
  3. In the Chain opened, select a network (Mainnet/Testnet) needed for your project.
  4. In the Endpoint field, copy the URL and paste it into your project's library or config file.
Use public endpoint

Congrats — you've just added a public endpoint into your project to enable blockchain interaction.

Basics with Premium plan

What's available for the Premium plan user:

  • Premium Endpoints and Advanced APIs at the corresponding rate limits.
  • Connection code snippets.
  • RPC methods testing tool.
  • Personal usage data.
  • Access to Hybrid infrastructure.
  • Requests charging and payments history data.

Interface schema

Below is the interface of the Premium service plan user that is all set to use RPC API Endpoints and Advanced APIs at the corresponding rate limits. Here is the path to access Premium and start using RPCs and Advanced APIs: Connect wallet —> Deposit funds —> Use private endpoints

  • Connect wallet: first things first, connecting your MetaMask wallet is the key to access your Premium account.

  • Deposit funds: second, you need to have a positive account balance to make any RPC requests.

  • Use private endpoints: finally, with a wallet connected and a balance topped up, you're all set to start using private RPC API endpoints.

Public Endpoints

Connect wallet

The wallet connection procedure is the following:

  1. Go to the RPC Service platform.
  2. In the top right corner, click Connect Wallet, then provide your public key for encryption and confirm interactions with our platform:
    • Click Provide — to use your public key for token encryption.
    • Click Sign — to confirm interactions with our platform.
MetaMask connection

Congrats — you now have an account in RPC Service, associated with your wallet.

Deposit funds

🖖

We’ve pegged the price of our API Credits to USD. It means that upon using ANKR tokens for PAYG, ANKR calculates into API Credits at the current ANKR/USD exchange rate on the moment of block's validation.

Initial deposit

Initial top up is a required step to access Premium services, as, upon depositing funds into your account, the system generates a personal JWT token granting access to the Premium plan functionality.

The initial top-up process is the following:

  1. In Navigation, click Pricing to open the corresponding pane.
  2. In Premium box, click Get Started with Premium to get scrolled to the Deposit box.
  3. Enter the amount of ANKR tokens you'd like to deposit (min. 1000 ANKR), click Top Up, and then confirm the operation in MetaMask.
Initial deposit

Congrats — you've added ANKR tokens to your account, and you're all set for using Premium services.

Subsequent top ups

As always the case, one day your account balance goes low — that's just the fact of life — and you need to top it up to continue querying blockchains:

  1. In Navigation, click Billing to open the pane.
  2. In the Top Up section (top right), enter the amount of ANKR tokens to deposit into your account, and then click Top Up.
  3. In the Top Up dialog, there are three substeps — two of them prompt you for the wallet confirmation:
    • Confirm top-up operation — click Next.
    • Grant ANKRs to contract — click Confirm, and then approve in the wallet.
    • Approve spending under contract — click Confirm, and then approve in the wallet.

Congrats — you've added ANKR tokens to your account, and you're all set for using Premium services.

Withdraw funds

⚠️

We’ve pegged the price of our API Credits to USD. Currently, withdrawals are to be requested via Support only.

Use private endpoints

Prerequisites:

As a Premium user, you have private Endpoints at hand to enable your projects to interact with a blockchain.

A Premium URL consists of a connection protocol (https or wss), domain name (rpc.ankr.com), common path of a blockchain to use (/eth), and your personal JWT token as the last segment of the path:

https://rpc.ankr.com/eth/6fe08843fa0966456eaa3fb19d4828b12389e71f48829f50df25e45bc5fd6cc5

To enable your project to interact with a blockchain, add the blockchain's URL into the project's library or config file:

  1. In Navigation, click Endpoints to open the pane.
  2. In the Chain Selection area, click the chain you'd like to query.
  3. In the Chain opened, select a network (Mainnet/Testnet) needed for your project.
  4. In the Endpoints field, copy the HTTPS or WebSocket URL and paste it into your project's library or config file.
Premium Endpoints

Congrats — you've just added a private endpoint into your project to enable blockchain interaction.