> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://docs.prividium.com/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

# faucet

## POST /faucet/claim

`POST /faucet/claim`

Request a testnet ETH claim from the faucet to one of the caller's associated wallets

### Request body (required) (`application/json`)

- `walletAddress` `string` _(required)_

### Responses

#### `200`: Default Response

Body (`application/json`):

- `txHash` `string` _(required)_
- `amountWei` `string` _(required)_
- `nextEligibleAt` `string <date-time>` _(required)_

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `429`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `500`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/faucet/claim \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "walletAddress": "string"
}'
```

```ts
fetch('/api/faucet/claim', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    walletAddress: 'string'
  })
})
```

## GET /faucet/status

`GET /faucet/status`

Return the current faucet cooldown state for the authenticated user

### Responses

#### `200`: Default Response

Body (`application/json`):

- `nextEligibleAt` `string <date-time>` _(required)_
- `lastSuccess` `object` _(required)_
  - `createdAt` `string <date-time>` _(required)_
  - `walletAddress` `unknown` _(required)_
  - `txHash` `string` _(required)_

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/faucet/status
```

```ts
fetch('/api/faucet/status')
```