---
title: "Admin faucet drip (no rate limit)"
method: POST
path: "/faucet/v1/admin"
tags: ["Faucet"]
---

# Admin faucet drip (no rate limit)

`POST /faucet/v1/admin`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/faucet/v1/admin`
- Auth: HTTP bearer and API key in header `x-admin-key`

Admin-only faucet with no rate limit and optional custom amount. Requires x-admin-key. Success waits for on-chain confirmation. An unknown confirmation outcome returns FAUCET_CONFIRMATION_PENDING with the broadcast transaction hash; inspect that transaction or balance instead of requesting another drip.

## Request body

- object
  - `address` string, required
  - `amount` string: Custom USDC amount

## Response `200`

USDC transfer confirmed

- object
  - `transaction_hash` string
  - `amount_usd_micros` integer
  - `token` string
  - `network` string
  - `funding_status` 'confirmed'

## Other responses

- `401`: Missing or invalid authentication. Run402-originated JSON bodies use the canonical ErrorEnvelope.
- `403`: Forbidden — invalid admin key
- `502`: FAUCET_TRANSFER_REVERTED: confirmed reverted transaction; funds were not delivered and the existing cooldown remains.
- `503`: Confirmation pending or faucet unavailable. FAUCET_CONFIRMATION_PENDING preserves transaction_hash and directs balance inspection; never automatically repeat an uncertain drip.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)