API: Rate & Pair Endpoints

Rate & Pair Endpoints

Query available pairs and real-time exchange rates.

GET /pairs

Returns all available exchange pairs with minimums.

{
  "pairs": [
    { "from": "XMR", "to": "BTC", "min_amount": "0.01", "max_amount": null, "estimated_time": "15-25 min" },
    { "from": "BTC", "to": "XMR", "min_amount": "0.0001", "max_amount": null, "estimated_time": "15-25 min" },
    { "from": "XMR", "to": "ETH", "min_amount": "0.01", "max_amount": null, "estimated_time": "10-18 min" }
  ]
}

GET /rate

Get the current rate for a specific pair.

Request:

GET /rate?from=XMR&to=BTC&amount=10&type=float

Response:

{
  "from": "XMR",
  "to": "BTC",
  "amount": "10",
  "rate": "0.00185",
  "estimated_receive": "0.01850000",
  "type": "float",
  "valid_until": "2026-05-10T10:05:00Z",
  "network_fee_included": true
}

Rate Caching

• —Float rates are indicative and update every 5–10 seconds
• —Fixed rates are valid for the time shown in `valid_until`
• —Cache rates for no more than 10 seconds to ensure accuracy

Batch Rate Query

Query multiple pairs at once:

GET /rates?pairs=XMR_BTC,XMR_ETH,BTC_XMR,ETH_XMR&type=float

Response:

{
  "rates": [
    { "pair": "XMR_BTC", "rate": "0.00185", "change_24h": "+1.24%" },
    { "pair": "XMR_ETH", "rate": "0.0341", "change_24h": "-0.53%" },
    { "pair": "BTC_XMR", "rate": "540.54", "change_24h": "-1.24%" },
    { "pair": "ETH_XMR", "rate": "29.33", "change_24h": "+0.53%" }
  ]
}