Reserve API Docs

Getting Started

Reserve API exposes deterministic digital-dollar macro signals for analysts and AI agents. Access is private-beta and uses API keys sent through x-api-key or Authorization: Bearer <key>.

API keys are provisioned manually during private beta after access review.

Authentication

API keys are shown only once at creation. Store securely and rotate regularly.

curl https://reserveanalytics.co/signals/digital-liquidity-stress \
  -H "x-api-key: ra_live_***"

// TypeScript
const res = await fetch("https://reserveanalytics.co/signals/digital-liquidity-stress", {
  headers: { "x-api-key": process.env.RESERVE_API_KEY! },
});
const json = await res.json();

# Python
import requests
r = requests.get(
  "https://reserveanalytics.co/signals/digital-liquidity-stress",
  headers={"x-api-key": "ra_live_***"},
  timeout=10,
)
print(r.json())

Endpoint Reference

Coming Soon

These signals are under development and will be promoted to live endpoints once data coverage and historical depth meet our quality bar.

Signal Response Contract

All /signals/* endpoints return a consistent envelope so bots and internal systems can parse responses without endpoint-specific adapters.

Machine-readable OpenAPI contract: /api/openapi/signals or /openapi/signals.json

curl https://reserveanalytics.co/openapi/signals.json

{
  "signal": "digital_liquidity_stress",
  "slug": "digital-liquidity-stress",
  "score": 42.18,
  "value": 42.18,
  "regime": "elevated",
  "trend": "falling",
  "confidence": 1,
  "last_updated": "2026-03-11T00:00:00.000Z",
  "as_of": "2026-03-11T00:00:00.000Z",
  "freshness": {
    "as_of": "2026-03-11T00:00:00.000Z",
    "expected_update_window_utc": "Mon-Fri around 22:30 UTC",
    "staleness_seconds": 10234
  },
  "components": {
    "supply_stress": 38.2,
    "peg_stress": 12.5,
    "premium_stress": 67.1,
    "dispersion_stress": 45.3,
    "funding_stress": 22.8,
    "tvl_stress": 31.0
  },
  "methodology_note": "DLSI v2 composite (beta). 6 sub-components with dynamic weight redistribution.",
  "version": "v2"
}

curl "https://reserveanalytics.co/signals/digital-liquidity-stress/history?limit=180" \
  -H "x-api-key: ra_live_***"

Embeds

During beta, the flagship Digital Liquidity Stress widget is available as an iframe embed.

<iframe
  src="https://reserveanalytics.co/embed/digital-liquidity-stress"
  width="420"
  height="240"
  style="border:0;"
  title="Reserve Analytics Digital Liquidity Stress"
></iframe>

Limits and Billing

Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Default per-key burst limits are 20/min (beta), 60/min (pro), and 120/min (scale). Beta includes 3,000 calls/month and Pro includes 25,000 calls/month. Monthly usage headers are returned as X-Monthly-Quota-Limit,X-Monthly-Quota-Used, and X-Monthly-Quota-Remaining. During private beta, upgrades are handled manually.

Errors

• 401 unauthorized key or expired key.
• 403 insufficient scope for endpoint.
• 429 rate-limit exceeded (includes retry metadata).
• 503 temporary upstream/data unavailability.

Changelog