request_testnet_tokensPython,latest
Go to PyPIRequest testnet tokens for your wallet.
Parameters
FaucetRequest
object
Required
address
string
Required
Blockchain generated unique identifier, associated with wallet (account), smart contract or other blockchain objects.
blockchain
string
Required
The testnet blockchain network the resource will be created on or is currently on.
Allowed valuesETH-SEPOLIAAVAX-FUJIMATIC-AMOYSOL-DEVNETARB-SEPOLIAUNI-SEPOLIABASE-SEPOLIAOP-SEPOLIA
native
boolean
Request native testnet tokens.
usdc
boolean
Request USDC testnet tokens.
eurc
boolean
Request EURC testnet tokens.
x_request_id
string
Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.
Responses
Example
1from circle.web3 import configurations
2from circle.web3 import utils
3
4client = utils.init_configurations_client(api_key=key)
5api_instance = configurations.FaucetApi(client)
6
7request = configurations.FaucetRequest.from_dict({
8 "address": "0xFF6458E7C49f54Da1593238Ae081Ca5f74638336",
9 "blockchain": "ETH-SEPOLIA",
10 "native": True,
11 "usdc": True,
12 "eurc": False
13})
14response = api_instance.request_testnet_tokens(faucet_request=request)
15print(response)
16ResponseChoose an example
1{
2 "code": 0,
3 "message": ""
4}Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.
