API Reference

Public Endpoints

Two endpoints are open — no API key required. Use GET /health for liveness checks and GET /config to read the platform's current client-facing facts instead of hard-coding them. Base URL: https://api.zuuppa.com.

Health#

GET

/health

No auth

Liveness probe. Returns 200 OK with a JSON body of counts and timings only — never an address, amount, or reference. Use status for load-balancer / uptime checks.

200 OKGET /health

JSON

{ "status": "ok", "detection_mode": "poll", "rpc_budget": { "...": "..." } }

Config#

GET

/config

No auth

Returns the platform's current client-facing facts so you don't hard-code them.

200 OKGET /config

JSON

{
  "checkout_window_seconds": 600,
  "network_fee_lamports": 5000,
  "rent_exempt_min_lamports": 890880,
  "platform_fee": { "percent": 0.0, "flat_lamports": 0, "enabled": false },
  "webhooks": { "max_attempts": 12, "events": ["intent.created", "..."] },
  "max_marketplace_fee_bps": 5000,
  "subscriptions": { "...": "..." }
}

What each field tells you:

Field	Meaning
`checkout_window_seconds`	The fixed checkout window in seconds (600 — every intent expires 10 minutes after creation).
`network_fee_lamports`	The Solana network fee paid by each sweep (~5000 lamports).
`rent_exempt_min_lamports`	The rent-exempt minimum; a fee leg below this is dropped and rolled into the seller's leg.
`platform_fee`	The platform fee in force: `percent`, `flat_lamports`, and `enabled`.
`webhooks`	`max_attempts` (retry ceiling) and `events` (the list of webhook event types).
`max_marketplace_fee_bps`	The maximum marketplace fee in basis points (5000).
`subscriptions`	Subscription limits when enabled; `null` when the subscription service is not enabled on this deployment.

Read it at startup

Fetch GET /config when your service boots rather than hard-coding the checkout window, fees, or event list. These are operator-managed and can change centrally without a code change on your side. See the full field list on the Overview and the fee mechanics in Core concepts.