Docs › Build with Beluga

API reference

Every endpoint of the public JSON API, each on its own page with parameters, responses, samples and a live "Try it" console. Everything the website does goes through this API; no keys needed.

The bridge API runs on mainnet since 2026-11-10, with real XMR and XMR2.

Endpoints

Prices & quotes

GET/api/compareCompare pricesGET/api/quoteExchange quoteGET/api/quote/wagyuWagyu quoteGET/api/redeemRedemption quote

Bridge orders

POST/api/depositCreate depositPOST/api/withdrawCreate redemptionGET/api/order/{id}Get order

Status

GET/api/statusReserves & statusGET/api/recentRecent swaps

Basics

  • Base URL: /api on this site (beluga.to).
  • Format: JSON in, JSON out. Send Content-Type: application/json with POST bodies (max 4 KB).
  • Amounts: order amounts are integer strings in atomic units (1 XMR = 1012); quotes are decimal numbers. See Money & settlement.
  • Errors: {"error": "message"} with a 4xx/5xx status. See Errors & retries.
  • Limits: 120 requests per minute per client. See Rate limits & keys.
  • No accounts: an order ID is the only handle to an order. Store it.

Status codes

CodeMeaning
200 201Success; 201 when an order was created.
400Invalid input or malformed JSON. Don't retry without changing the request.
404Unknown order ID or path.
429Rate limit reached; retry after the current minute.
503No reliable market price right now; retry with backoff.

First steps

New here? The developer quickstart walks through a full bridge order with curl. States and transitions are in Order lifecycle.