Reference > HTTP API
HTTP API reference
Document Quovra HTTP endpoints.
HTTP API reference
Quovra's public HTTP surface is intentionally small. Settlement logic lives on-chain.
POST /api/faucet
Mint devnet-only test USDC to a wallet.
| Field | Value |
|---|---|
| Method | POST |
| Authentication | None for users; server requires configured mint authority |
| Content-Type | application/json |
| Rate limit | 30 seconds per wallet in-process |
Headers
http
Content-Type: application/jsonRequest body
json
{
"wallet": "<SOLANA_WALLET_ADDRESS>"
}Response
json
{
"signature": "<devnet transaction signature>",
"amount": 100000000,
"mint": "C4ERwQWEttoeawS5wy1NGZRhqphK7PeGtM4mPAHvcf4b"
}Status codes
| Status | Meaning |
|---|---|
| 200 | Mint submitted |
| 400 | Missing or invalid wallet |
| 429 | Cooldown active |
| 503 | Faucet not configured |
| 500 | Faucet failed |
cURL
bash
curl -X POST https://quovra.xyz/api/faucet \
-H 'Content-Type: application/json' \
-d '{"wallet":"<SOLANA_WALLET_ADDRESS>"}'JavaScript
js
const res = await fetch("https://quovra.xyz/api/faucet", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ wallet }),
})
const data = await res.json()TypeScript
ts
type FaucetResponse = { signature: string; amount: number; mint: string }
const data = (await res.json()) as FaucetResponsePython
python
import requests
r = requests.post("https://quovra.xyz/api/faucet", json={"wallet": wallet})
print(r.json())Go
go
// POST JSON to /api/faucet with net/http.Rust
rust
// Use reqwest::Client::post(...).json(...).send().await.Java
java
// Use java.net.http.HttpClient with JSON body.C#
csharp
// Use HttpClient.PostAsJsonAsync("https://quovra.xyz/api/faucet", body).Related pages
Search keywords
REST, HTTP, faucet, test USDC, status codes
Last updated: [YYYY-MM-DD]