# Faucet API

Request AGLS on the Aglais test network from a server or curl.

The faucet sends test AGLS to an address on the Aglais test network. Its base URL is `https://faucet.aglais.quip.network`. It is an API with no web page: the root path returns 404.

> **Not callable from a browser**
>
> The CORS preflight for `POST /request` returns 405 with no `Access-Control-Allow-Methods` header, so a browser refuses to send the JSON request. Call the faucet from a server or curl. This page has no request playground for the same reason.

## Request a drip

One request sends one drip of 10 AGLS. Requests are rate-limited per destination.

```sh
curl -X POST https://faucet.aglais.quip.network/request \
  -H 'Content-Type: application/json' \
  -d '{"dest": "<your address>"}'
```

`dest` takes an SS58 address, a 0x-prefixed 64-hex AccountId, or a 0x-prefixed 40-hex EVM address. For an XQuad keystore, use its `account_id_hex` field, as [Submit Your First Compute Job](/docs/compute/submit-a-job#fund-your-account-from-the-faucet) describes.

**`POST https://faucet.aglais.quip.network/request`**: Sends one drip of 10 AGLS to the destination. Rate-limited per destination.

Request body, `application/json`:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dest` | `string` | yes | The address to fund: an SS58 address, a 0x-prefixed 64-hex AccountId, or a 0x-prefixed 40-hex EVM address. |

Responses:

| Status | Description |
| --- | --- |
| `403` | The address already holds more than one drip. It can draw again once spending takes it back below that. |
| `429` | With `retry_after_seconds`, the address was funded seconds ago: wait that long and retry. Without it, a request for the address is still in flight. |
| `2XX` | The drip was requested. The exact status code and response body are not documented. |

## Check health

```sh
curl https://faucet.aglais.quip.network/health
```

**`GET https://faucet.aglais.quip.network/health`**: Reports whether the faucet is up. Dispenses nothing.

Responses:

| Status | Description |
| --- | --- |
| `200` | The faucet is up. Body: `{"status":"ok"}`. |

## Other paths

Read-only requests observed on 2026-11-03. None of them dispense anything.

| Request | Response |
| --- | --- |
| `GET /` | 404 |
| `GET /request` | 405, `Allow: POST` |
| `OPTIONS /request` | 405, `Allow: POST` |