> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhaios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/testing/fund-wallet

> Fund a wallet with test ETH and USDC on a managed test RPC.

# POST /v1/testing/fund-wallet

<Note>**Free** — No authentication required. See [Test RPCs](/concepts/test-rpc).</Note>

Fund a wallet on a managed test RPC with ETH and/or USDC for pre-production testing. Balances are minted on chain forks only — no real tokens are spent or created.

This endpoint is only available on staging and production deployments with testing tools enabled.

## Parameters

<ParamField body="chain" type="string" required>
  Target chain: `"ethereum"` or `"base"`.
</ParamField>

<ParamField body="walletAddress" type="string" required>
  Wallet address to fund (`0x...`).
</ParamField>

<ParamField body="ethWei" type="string" optional>
  Amount of ETH to mint, in wei. Max `20000000000000000` (0.02 ETH) per call.
</ParamField>

<ParamField body="usdcAmount" type="string" optional>
  Amount of USDC to mint, in base units (6 decimals). Max `50000000` (50 USDC) per call.
</ParamField>

<Note>At least one of `ethWei` or `usdcAmount` must be provided.</Note>

## Example

```bash theme={null}
curl -X POST https://api.staging.rhaios.com/v1/testing/fund-wallet \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "base",
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "ethWei": "2000000000000000",
    "usdcAmount": "5000000"
  }'
```

## Response

```json theme={null}
{
  "success": true,
  "environment": "staging",
  "chain": "base",
  "chainId": 8453,
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "forkId": "fork-abc123",
  "funded": {
    "eth": {
      "requestedAmountWei": "2000000000000000",
      "resultingBalanceWei": "2000000000000000"
    },
    "usdc": {
      "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "requestedAmountBaseUnits": "5000000",
      "resultingBalanceBaseUnits": "5000000"
    }
  },
  "limits": {
    "maxEthWeiPerCall": "20000000000000000",
    "maxUsdcBaseUnitsPerCall": "50000000"
  },
  "allowlistEnforced": false
}
```

Key fields:

* `funded.eth` / `funded.usdc` — Requested amounts and resulting on-fork balances
* `forkId` — The test RPC fork that was funded
* `limits` — Current per-call caps
* `allowlistEnforced` — Whether the server restricts funding to an allowlisted set of wallets