Individuals
Businesses
Developers
Contact us
Query & Transact

How to create and manage Query & Transact clusters

Query & Transact customers work with one of our account managers to create and manage private RPC nodes.  If you’re interested in becoming a customer, please contact us using our Cloud Interest Form.  If you’re an existing customer, reach out to your dedicated account manager.

Supported protocols for Query & Transact clusters

Currently Coinbase Cloud supports the following protocols for Query & Transact (QT) clusters:

 Algorand   Cosmos Hub   Ethereum   Kusama   Provenance 
 Avalanche   Crypto.org   Eth 
 Classic 
 Litecoin   Solana 
 Bitcoin   Diem   Eth2.0   Near   Tezos
 Bitcoin
 Cash 
 Dogecoin   Evmos   Oasis   Tron 
 Bitcoin
 SV 
 EOS   Flow   Polkadot   ZCash 

Other protocols are in development and will be shared upon release. 

If a protocol you are interested in isn’t listed, please submit a request through our Cloud Interest Form to let us know.

Launch a Query & Transact (QT) cluster

You can easily spin up a Query & Transact cluster from Coinbase Cloud.

  1. Select the dropdown menu icon in the top left

  2. Select QT clusters from the dropdown

  3. Select your desired protocol from the list

  4. Select Create

  5. Name your cluster

  6. Choose a provider and region

  7. Select your desired number of nodes

  8. Select a network

  9. Select Review & pay

  10. Complete required steps for payment and for reading and agreeing to the Terms of Service

  11. Select Launch cluster

Once launched, it can take a cluster anywhere from a few minutes to several days in order to sync with the network. The wait time depends upon the protocol being used. A cluster is not active until it is synced and running. You will receive an email to alert you when the cluster is active.

Once your cluster is ready, to access it you will need to create an API access token or public access client.

When you are notified that your QT cluster is running, you will need to create either a public access client or an API access token in order to start using your cluster. A public access client allows for access without a username and password. API access tokens require usernames and passwords for authentication. Both options can have rate limits and IP allow lists.

Manage your Query & Transact (QT) cluster

API access tokens allow you to require a username and password (basic authentication) to access your Query & Transact cluster.

You can create multiple API access tokens, each with its own rate limits (number of requests per second/minute/hour and maximum requests per day). By default, all tokens allow unlimited requests.

Each token can also have its own authorized IP list. This list restricts access to your QT cluster by only permitting requests from IP addresses you specify. You can add as many IP addresses to your token’s allow list as needed by using commas to separate each domain. Addresses must be formatted as either 192.168.0.1 or 10.0.0.1/22. As a convenience, IP addresses can be formatted to include Classless Inter-Domain Routing (CIDR) information. 

API access tokens are long-lived and revocable at any time.

If you prefer to allow for public access to your cluster, create a public access client that does not require a username and password. Note that public access clients can have rate limits and IP allow lists.

QT clusters can have anywhere from 1 to 40 nodes across providers and regions. If at any time you want to increase or decrease the number of nodes in your cluster, log in to Coinbase Cloud and enter the cluster details from the Query & Transact homepage. Then go to the Configuration tab and add or remove nodes using the table provided.

Moving nodes from one region to another will cause temporary performance issues with your cluster.

  • Moving some nodes: When you remove some, but not all, nodes from one region and add new nodes to another region, you may experience a temporary degradation of service due to the time required for your new nodes to sync with the chain.

  • Moving all nodes: Removal of nodes from a cluster occurs instantaneously but addition of nodes requires time for them to sync with the chain. If you remove all nodes from a region before you have added nodes to a new region, you will experience a temporary disruption of service.

You can run as many Query & Transact clusters at a time as you need. Log in to create a new cluster or submit a request for access via the Coinbase Cloud platform to get access to more protocols.

To delete your cluster, you must remove all of its nodes. This action is permanent. A deleted cluster can not be recovered.

  1. Go to the Configuration tab 

  2. Click Delete all nodes in the table

  3. Enter the name of your cluster in the modal window

  4. Click Delete cluster

In order to prevent you from paying exorbitant gas fees, our clusters have default gas limits per call. We are able to change this amount to unlimited by request. Log in to the Coinbase Cloud platform to submit a request to discuss options.

footer cta icon

Can't find what you're looking for?

Contact us