> ## Documentation Index
> Fetch the complete documentation index at: https://circle-devdocs-test-ai-codegen-component.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Receive an Inbound Transfer
> Initiate a currency transfer into a developer-controlled wallet you've already created.
Circle Wallets provide a comprehensive developer solution to storing, sending,
and spending Web3 digital currencies and NFTs. You or your users can manage
asset infrastructure. Circle provides a one-stop-shop experience with all the
tools and services to handle the complex parts, including security, transaction
monitoring, account recovery flows, and more.
This guide outlines initiating a currency transfer into a previously created
developer-controlled wallet. You'll learn to make API requests via Circle's API
references or cURL requests. In this guide, you'll find cURL requests presented
inline, while API references are linked from the API endpoint text. You can find
instructions on using it in the
[testing via the reference pages](/api-reference) guide.
* As with most of our quickstarts, all API calls and transactions in this guide
occur within the Testnet environment; no real-world funds will be transferred.
* If you have not yet created a developer-controlled wallet, see
[this guide](/wallets/dev-controlled/create-your-first-wallet).
## 1. Acquire the Wallet Address
To receive funds on-chain, you will need the wallet's address. The address is
the on-chain identifier provided to the sending wallet or
faucet in the following step. To retrieve the address, make
a request to [`GET
/wallets`](/api-reference/wallets/developer-controlled-wallets/get-wallets) as shown
below. You should also note down the `wallets.id` this will be used in step 3.
```javascript Node.js SDK theme={null}
// Import and configure the developer-controlled wallet SDK
const {
initiateDeveloperControlledWalletsClient,
} = require("@circle-fin/developer-controlled-wallets");
const circleDeveloperSdk = initiateDeveloperControlledWalletsClient({
apiKey: "",
entitySecret: "",
});
const response = await circleDeveloperSdk.listWallets();
```
```coffeescript Python SDK theme={null}
from circle.web3 import developer_controlled_wallets
from circle.web3 import utils
client = utils.init_developer_controlled_wallets_client(api_key=key, entity_secret=entitySecret)
# create an api instance
api_instance = developer_controlled_wallets.WalletsApi(client)
try:
resposne = api_instance.get_wallets()
print(resposne)
except developer_controlled_wallets.ApiException as e:
print("Exception when calling WalletsApi->get_wallets: %s\n" % e)
```
```curl Curl theme={null}
curl --request GET \
--url 'https://api.circle.com/v1/w3s/wallets' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'authorization: Bearer '
```
```json Response Body theme={null}
{
"data": {
"wallets": [
{
"id": "ce714f5b-0d8e-4062-9454-61aa1154869b",
"state": "LIVE",
"walletSetId": "0189bc61-7fe4-70f3-8a1b-0d14426397cb",
"custodyType": "DEVELOPER",
"address": "0xf5c83e5fede8456929d0f90e8c541dcac3d63835",
"blockchain": "MATIC-AMOY",
"accountType": "SCA",
"updateDate": "2023-08-03T19:33:14Z",
"createDate": "2023-08-03T19:33:14Z"
}
]
}
}
```
## 2. Transfer Testnet Currency
Send testnet currency from an external wallet outside the Programmable Wallet
infrastructure into your applicable wallet `address`. The best way to achieve
this is through the use of a faucet. In our case, we will
use the [USDC Faucet](https://usdcfaucet.com/) to transfer USDC on Polygon Amoy
to the wallet.
Here is a list of reputable native token faucets for each blockchain:
| Blockchain | USDC faucet | Testnet native token faucet |
| ---------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- |
| Aptos Testnet | [USDC on APT Faucet](https://faucet.circle.com/) | [Aptos APT Faucet](https://aptos.dev/en/network/faucet) |
| Arbitrum Sepolia | [USDC on ARB Faucet](https://faucet.circle.com/) | [Sepolia ARB Faucet](https://www.alchemy.com/faucets/arbitrum-sepolia) |
| Avalanche Fuji | [USDC on AVAX Faucet](https://faucet.circle.com/) | [Fuji AVAX Faucet](https://core.app/en/tools/testnet-faucet/?token=C) |
| Base Sepolia | [USDC on BASE Faucet](https://faucet.circle.com/) | [Sepolia Base Faucet](https://docs.base.org/chain/network-faucets) |
| Ethereum Sepolia | [USDC on ETH Faucet](https://faucet.circle.com/) | [Sepolia ETH Faucet](https://sepoliafaucet.com/) |
| Optimism Sepolia | [USDC on OP Faucet](https://faucet.circle.com/) | [Sepolia OP Faucet](https://docs.optimism.io/app-developers/tools/build/faucets) |
| Polygon Amoy | [USDC on MATIC Faucet](https://faucet.circle.com/) | [Amoy MATIC Faucet](https://www.alchemy.com/faucets/polygon-amoy) |
| Solana Devnet | [USDC on SOL Faucet](https://faucet.circle.com/) | [Devnet SOL Faucet](https://faucet.solana.com/) |
| Unichain Sepolia | [USDC on UNI Faucet](https://faucet.circle.com/) | [Sepolia UNI Faucet](https://docs.unichain.org/docs/tools/faucets) |
## 3. Check the Transfer State
Once an inbound transfer is made to the address and completed, Circle sends a
notification to a [subscribed endpoint](/wallets/webhook-notifications). The
Webhook notification will be similar to the one below.
```json Webhook Request Body theme={null}
{
"subscriptionId": "d4c07d5f-f05f-4fe4-853d-4dd434806dfb",
"notificationId": "05b3f4e5-ec27-44b8-aa40-3698577f6d92",
"notificationType": "transactions.inbound",
"notification": {
"id": "2f4b6bcd-a752-5d8b-996b-92e3e04bd33b",
"blockchain": "MATIC-AMOY",
"walletId": "ce714f5b-0d8e-4062-9454-61aa1154869b",
"tokenId": "38f2ad29-a77b-5a44-be05-8d03923878a2",
"destinationAddress": "0x075e62c80e55d024cfd8fd4e3d1184834461db57",
"amounts": ["10"],
"nftTokenIds": [],
"state": "COMPLETED",
"transactionType": "INBOUND",
"createDate": "2023-07-28T16:03:08Z",
"updateDate": "2023-07-28T16:06:40Z"
},
"timestamp": "2023-07-28T16:06:40.907831464Z",
"version": 2
}
```
Alternatively, you can poll
[`GET /transactions`](/api-reference/wallets/developer-controlled-wallets/list-transactions)
using the `walletId` as query parameter.
```javascript Node.js SDK theme={null}
const response = await circleDeveloperSdk.listTransactions({
walletIds: ["ce714f5b-0d8e-4062-9454-61aa1154869b"],
});
```
```coffeescript Python SDK theme={null}
# create an api instance
api_instance = developer_controlled_wallets.TransactionsApi(client)
try:
resposne = api_instance.list_transactions(wallet_ids="ce714f5b-0d8e-4062-9454-61aa1154869b")
print(resposne)
except developer_controlled_wallets.ApiException as e:
print("Exception when calling TransactionsApi->list_transactions: %s\n" % e)
```
```curl cURL theme={null}
curl --request GET \
--url 'https://api.circle.com/v1/w3s/transactions?walletIds=ce714f5b-0d8e-4062-9454-61aa1154869b' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'authorization: Bearer '
```
```json Response Body theme={null}
{
"data": {
"transactions": [
{
"id": "97d22a88-6d25-5947-a7b6-61b3dc668057",
"blockchain": "MATIC-AMOY",
"tokenId": "38f2ad29-a77b-5a44-be05-8d03923878a2",
"walletId": "ce714f5b-0d8e-4062-9454-61aa1154869b",
"sourceAddress": "0x6e5eaf34c73d1cd0be4e24f923b97cf38e10d1f3",
"destinationAddress": "0xf5c83e5fede8456929d0f90e8c541dcac3d63835",
"transactionType": "INBOUND",
"custodyType": "DEVELOPER",
"state": "CONFIRMED",
"amounts": ["10"],
"nfts": null,
"txHash": "0xdd2f81a78605dcad759265c703fb2b4c507c5ea100319338422714bfcde77225",
"blockHash": "0x4df6092fdb868331614771ff11944b43051cf6ed1067f8cfa55e9d40ef61426b",
"blockHeight": 9423950,
"networkFee": "",
"firstConfirmDate": "2023-07-28T19:07:24Z",
"operation": "TRANSFER",
"abiParameters": null,
"createDate": "2023-07-28T19:07:34Z",
"updateDate": "2023-07-28T19:07:37Z"
}
]
}
}
```
You have successfully transferred 10 USDC into your developer-controlled wallet!
Now you can move on to
[transferring tokens from wallet to wallet](/wallets/dev-controlled/transfer-tokens-across-wallets).