Limits

curl "$RHEON_API/v1/limits?currency=EUR" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "limits": [
    {
      "currency": "EUR",
      "rail": "sepa_instant",
      "direction": "both",
      "max": "100000.00",
      "min": null,
      "settlement": "instant"
    },
    {
      "currency": "EUR",
      "rail": "sepa",
      "direction": "both",
      "max": null,
      "min": null,
      "settlement": "t+0..t+1"
    },
    {
      "currency": "EUR",
      "rail": "swift",
      "direction": "payout",
      "max": null,
      "min": null,
      "settlement": "t+1..t+3"
    }
  ]
}

Returns the per-transfer ceiling and the settlement time for every currency and rail. Limits are set by the rails themselves, so read them at runtime - a hard-coded ceiling goes stale without warning. The human-readable tables, grouped by region, are on Coverage.

Request

string

Only limits for this ISO 4217 currency, e.g. EUR. Omit for all.

Response

array

One entry per currency and rail combination.

Show limits[]

string

ISO 4217 code.

string

The rail the limit applies to, e.g. sepa_instant.

string

pay_in, payout, or both.

string | null

The per-transfer ceiling as a decimal string in the currency’s major unit. null where the rail sets no fixed ceiling.

string | null

The per-transfer minimum, where the rail has one. null otherwise.

string

How long the rail takes, e.g. instant, t+0, t+1, t+1..t+3, or under_2h.

The stablecoin deposit path has no fixed ceiling here - it is bounded by live liquidity on the route, which is why a quote can come back no_route. That is a normal, temporary answer, not an error to retry in a loop.

curl "$RHEON_API/v1/limits?currency=EUR" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "limits": [
    {
      "currency": "EUR",
      "rail": "sepa_instant",
      "direction": "both",
      "max": "100000.00",
      "min": null,
      "settlement": "instant"
    },
    {
      "currency": "EUR",
      "rail": "sepa",
      "direction": "both",
      "max": null,
      "min": null,
      "settlement": "t+0..t+1"
    },
    {
      "currency": "EUR",
      "rail": "swift",
      "direction": "payout",
      "max": null,
      "min": null,
      "settlement": "t+1..t+3"
    }
  ]
}

Errors

HTTP	`code`	When
400	`invalid_request`	`currency` is not a known ISO 4217 code.
401	`unauthorized`	Missing, malformed, or unknown API key.
429	`rate_limited`	Over your key’s rate limit.
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Bank transfers

Virtual accounts

Reference

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors