Setting Up Your Testnet API Key with our Web3 Services Console

Ready to begin?

If you're looking to use Circle's Programmable Wallets and dive into this interactive quickstart, the first step is to create a developer account on Circle's Web3 Services Console. Signing up is straightforward and cost-free for testing purposes—just use your email address to register.

Set up your account

To access the full range of capabilities outlined in this Quickstart guide, begin by setting up an account on Circle's Web3 Services Console. This will enable you to explore and utilize the features effectively.

To fully utilize Circle's Web3 Services Platform, obtaining an API key is essential. The API key acts as a unique identifier, allowing personalized interaction with our APIs and serving as your entry point to the features and functionalities that enable the creation of powerful Web3 applications

Understanding Testnet versus Mainnet Environments

Before proceeding, it's critical to differentiate two fundamental environments in blockchain development: Testnet and Mainnet.


Testnet is akin to a training ground for developers. It's a simulated environment where you can develop, test, and polish your applications with confidence. In this space, you can execute transactions and test various scenarios without any financial implications, as Testnet does not involve real cryptocurrencies or assets.


In contrast, Mainnet is where everything goes live. This network handles actual transactions with genuine digital currencies. Operating on Mainnet means dealing with real-world consequences and genuine assets. The results of actions performed here are immediate and impactful.

While it may seem exciting to leap directly into Mainnet, it is crucial to rigorously test and validate your applications within the Testnet environment first. This precaution ensures that all systems and functionalities operate correctly before you transition to a live environment where stakes are higher. Once you have a thoroughly vetted application in Testnet, you can smoothly migrate to Mainnet operations.

Please note that for the duration of this tutorial, we'll concentrate on Testnet to guarantee a secure learning experience. Your Testnet API key serves as the gateway to this development

Creating your API key

To proceed with this guide, you'll need to create a standard API key. Here's how to generate it:

  • 1

    Login to the Console

    Ensure you're signed in to Circle's Web3 Services Console.

  • 2

    Access the API Keys Section

    Navigate to the API keys area and commence creating a new API key by selecting the call-to-action (CTA) button located in the top right corner. Open API Key Section

    List of API keys
  • 3

    Set Up your new API key

    Give your new API key a name and select the option for a Standard Key.

    Create new API key form
  • 4

    Copy & Store safely

    Immediately after your API key is generated, make sure to copy it and keep it in a secure location. It’s important to safeguard your key because it cannot be retrieved again if lost and should never be disclosed publicly.

    API key successfully created

The power of Testnet

With your Testnet API key in hand you're now primed to:

Test With Assurance

Engage in robust testing of your applications, smart contracts, and other blockchain innovations, all within a safe environment that simulates real-world operations. This sandbox allows for trial and error without any financial stakes, so mistakes carry no monetary risk.

Achieve Broad Compatibility

Testnet serves as a preparatory platform for launches on various blockchains. Whether your focus is on Ethereum, Polygon, or Avalanche, Testnet provides insights into how your applications will perform across different ecosystems.

Encourage Innovation

The Testnet environment is the perfect place to brainstorm and develop new blockchain solutions. Here, you have the license to push boundaries and explore various possibilities without financial constraints.

Iterate Swiftly

Benefit from the ability to quickly refine your projects based on immediate feedback and test insights. The adaptable nature of Testnet supports rapid prototyping and swift iteration, which can lead to faster advancements and better outcomes in your development cycle.

Need help or have questions?

Here are some helpful links:

🎮Join our Discord Community: Engage, learn, and collaborate.
🛎Visit our Help-Desk Page: Dive into curated FAQs and guides.
📧Direct Email: We're always a message away.
📖Read docs: Check out our developer documentation.
© 2023 Circle Technology Services, LLC. All rights reserved.