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.

FieldValue
MethodPOST
AuthenticationNone for users; server requires configured mint authority
Content-Typeapplication/json
Rate limit30 seconds per wallet in-process

Headers

http
Content-Type: application/json

Request body

json
{
  "wallet": "<SOLANA_WALLET_ADDRESS>"
}

Response

json
{
  "signature": "<devnet transaction signature>",
  "amount": 100000000,
  "mint": "C4ERwQWEttoeawS5wy1NGZRhqphK7PeGtM4mPAHvcf4b"
}

Status codes

StatusMeaning
200Mint submitted
400Missing or invalid wallet
429Cooldown active
503Faucet not configured
500Faucet 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 FaucetResponse

Python

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]