Stabledesk · API

Real-time stablecoin analytics for the Arc testnet, as a REST API. ← Back to the terminal

Get a free API key

Free tier: 60 requests/min, all read endpoints, 1 alert. No signup.

Send it as the X-API-Key header on every /v1 request.

Authentication

curl https://stabledesk.xyz/v1/network \
  -H "X-API-Key: sbd_demo"

sbd_demo is a shared public key for quick testing. Generate your own for real usage. No key needed for /v1/status.

Endpoints

GET/v1/statusHealth + latest block (public)
GET/v1/chain/uptime?days=30 availability record — read coveragePct before uptimePct
GET/v1/networkBlock time, TPS, gas, cost/transfer
GET/v1/network/feesFees in USDC: per tx, per day, per $1M moved
GET/v1/addresses/filteredHigh-frequency addresses excluded from adjusted volume
GET/v1/stablecoinsSupply, dominance, 24h summary
GET/v1/stablecoins/history?token=USDC&range=24h time series
GET/v1/stablecoins/{token}Per-token detail, issuance (raw + bridge-adjusted) and size distribution
GET/v1/protocolsRegistry + TVL + flow per protocol · ?format=csv
GET/v1/protocols/{id}One protocol, with its per-contract breakdown
GET/v1/protocols/unnamedContracts holding balances no protocol claims · ?format=csv
GET/v1/tvlChain TVL, by token and by protocol
GET/v1/tvl/history?protocol=id&days=30 daily TVL · ?format=csv
GET/v1/rankingsDaily standings + the ready-to-post digest
GET/v1/search?q= protocols, tokens and addresses
GET/v1/addresses/top?limit=20 top by volume
GET/v1/transfers/largest?limit=20 biggest transfers
GET/v1/address/{addr}Stats + recent transfers for an address
POST/v1/keysMint a free key
POST/v1/billing/orderGet a USDC-on-Base payment address pro
GET/v1/billing/orderCheck your latest order / tier status
GET/v1/alertsList your alerts
POST/v1/alertsCreate a webhook alert
DELETE/v1/alerts/{id}Remove an alert

Machine-readable

The full API is described in /openapi.json (OpenAPI 3.1) — every endpoint, parameter, response shape and error code, generated from the running configuration so it can't drift from what the API actually serves. Point a client generator, an IDE or an agent at it rather than reading this page.

/llms.txt is the short version for language models: what this measures, where the data comes from, and the two or three conventions you need before quoting a number from it.

Tiers

TierRate limitAlertsPrice
Free60 req/min1 webhook$0
Pro600 req/min20 webhookscoming soon

Webhook alerts

Free tier includes 1 webhook alert (Pro: 20). Register a rule and get an HTTPS POST (Discord / Slack / Telegram / your backend) whenever a matching stablecoin transfer is indexed. Fires at most once per minute per rule. Webhooks must be public https:// URLs.

curl -X POST https://stabledesk.xyz/v1/alerts \
  -H "X-API-Key: YOUR_KEY" -H "content-type: application/json" \
  -d '{"token":"USDC","minAmount":100000,"webhook":"https://discord.com/api/webhooks/…"}'

curl -X DELETE https://stabledesk.xyz/v1/alerts/1 \
  -H "X-API-Key: YOUR_KEY"