Quote a deposit

Prices a cross-chain deposit for a given source, destination, and amount. The quote it returns is the input to /deposit/transaction.

Request

object

required

Where the funds come from.

Show source

string

required

The user’s EVM wallet address on the source chain.

number

required

Source chain id (e.g. 10 for Optimism, 42161 for Arbitrum).

string

required

The source token contract address on the source chain (e.g. USDC).

object

required

Where the funds land.

Show destination

string

required

The recipient EVM address. In the non-custodial flow this is the user’s own wallet.

number

Landing chain id. Omit to settle on Arbitrum (42161), which is the default and what every existing integration means.

string

Landing token contract address on destination.chain. Omit to settle in USDC on Arbitrum.

destination.chain and destination.token go together: send both or neither. Sending only the chain is rejected, because keeping Arbitrum’s USDC address on another chain would quote a token that does not exist there.

string

required

The amount, as a decimal string in the smallest unit of whichever side amountMode pins down: the source token for exact-in, the destination USDC for target-out (e.g. "5000000" = 5 USDC).

string

Which side of the trade amount fixes. Omit for exact-in, which is the default and matches every existing integration.

exact-in - the payer spends exactly amount; how much lands is whatever the route delivers.
target-out - at least amount must land at the destination, and we solve backwards for what the payer spends. This is exact out: the figure to collect is fixed, so the payer’s side has to flex.

target-out is a floor, not an exact figure. Routes target “at least X”, so a little more than amount usually arrives. Treat any excess as the recipient’s.

A provider that cannot honour the requested mode returns no_route rather than quoting the other one - a quote in the wrong mode looks correct and settles the wrong amount.

string

required

Funding method. Only "crypto" is supported here. For card use /card/quote; for bank transfers see /fiat/onboard.

Response

string

Opaque identifier for the route source. Treat it as a black box and pass it back unchanged to /deposit/transaction and /deposit/status.

string

The amount that will be delivered at the destination, as a decimal string in the destination token’s smallest unit (USDC).

number

Optional. Unix timestamp (seconds) after which the quote may no longer be valid.

object

Opaque route data. Do not inspect or modify it - pass the whole quote object back to /deposit/transaction.

curl -X POST "$RHEON_API/deposit/quote" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "address": "0x1111111111111111111111111111111111111111",
      "chain": 10,
      "token": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"
    },
    "destination": {
      "address": "0x2222222222222222222222222222222222222222"
    },
    "amount": "5000000",
    "method": "crypto"
  }'

# "Whatever it takes - land exactly 100 USDC at the destination."
curl -X POST "$RHEON_API/deposit/quote" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "address": "0x1111111111111111111111111111111111111111",
      "chain": 8453,
      "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    },
    "destination": {
      "address": "0x2222222222222222222222222222222222222222"
    },
    "amount": "100000000",
    "amountMode": "target-out",
    "method": "crypto"
  }'

{
  "provider": "rheon-router",
  "outAmount": "4986000",
  "validUntil": 1720800000,
  "payload": { "route": "..." }
}

{
  "error": {
    "code": "no_route",
    "message": "No route available for this pair."
  }
}

Errors

HTTP	`code`	When
400	`invalid_request`	A field is missing or malformed, `method` is not `"crypto"`, or `amountMode` is not one of `exact-in` / `target-out`.
400	`no_route`	No provider can route this source/destination pair.
429	`rate_limited`	Over the rate limit (5 requests / 10s / IP).
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Bank transfers

Quote a deposit

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors