---
title: "Fund wallet with MockUSDC"
method: POST
path: "/api/v1/faucet/usdc"
tags: ["Developer Tools"]
---

# Fund wallet with MockUSDC

`POST /api/v1/faucet/usdc`

Mints MockUSDC to the developer's wallet AND to the X402_PAYMENT_ADDRESS on their behalf. The paymentAddressTxHash in the response is what the developer passes as the X-402-Payment header for their first task submission. Rate limited to 1 request per wallet per 24 hours.

## Request body

- object
  - `wallet` string, required — Developer EOA wallet address to receive MockUSDC
  - `amount` number — USDC amount to mint (default: 10, max: 100)

## Response `200`

MockUSDC minted — use paymentAddressTxHash as your X-402-Payment header

- object
  - `devWalletTxHash` string — Transaction hash — MockUSDC minted to developer wallet
  - `paymentAddressTxHash` string — Transaction hash — MockUSDC minted to X402_PAYMENT_ADDRESS. Use this as the txHash in your X-402-Payment header.
  - `usdcMinted` number — USDC amount minted
  - `creditsAdded` number — Off-chain credits added to your account
  - `cooldownUntil` string, date-time — When you can call the faucet again for this wallet
  - `paymentAddress` string — The X402_PAYMENT_ADDRESS that was funded
  - `instructions` string — Pre-built X-402-Payment header value — copy and use directly

## Other responses

- `400` — Invalid wallet address
- `401` — Missing or invalid API key
- `429` — Rate limit exceeded — 1 request per wallet per 24h
- `503` — Faucet not configured on this instance

## Changes

- **2026-03-25** `d7638df26f2c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/changes/api/v1/faucet/usdc/post.md)

---

[API](https://skmtc.dev/humbleaf/apis/agentchain-prior-api.md) · [All operations](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/llms.txt) · [OpenAPI document](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/revisions/d7638df26f2c?raw)