Get a swap quote

Returns a price quote for swapping tokens between any two supported networks and token pairs. No authentication required.

Routing is handled internally:

• Same-chain pairs on POL or BSC — executed via the Rach FiatSwapV2 smart contract (0.3% platform fee)
• All other pairs — routed through a cross-chain bridge

The response format is identical regardless of the route taken.

amount_in must be in base units (wei / smallest denomination) as an integer string:

• USDT on Polygon (6 decimals): 1000000 = 1 USDT
• MATIC / BNB (18 decimals): 1000000000000000000 = 1 MATIC / BNB
• Use "native" as the token address for the chain’s native coin (MATIC on POL, BNB on BSC)

GET /api/v1/swap/quote

Get a swap quote

cURL

curl --request GET \
  --url https://api.rach.finance/api/v1/swap/quote

200

{
  "estimated_seconds": 30,
  "expires_at": 1720000030,
  "from_amount": "1000000",
  "from_chain": "POL",
  "from_token": "<string>",
  "platform_fee": "3000",
  "to_amount_expected": "997012",
  "to_amount_min": "992047",
  "to_chain": "BSC",
  "to_token": "<string>"
}

Query Parameters

from_chain · string · required

Source chain identifier (POL, BSC, ETH, ARB, etc.)

Example:

"POL"

to_chain · string · required

Destination chain identifier

Example:

"BSC"

from_token · string · required

Token contract address on the source chain, or "native" for the chain's native coin

Example:

"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"

to_token · string · required

Token contract address on the destination chain, or "native"

Example:

"0x55d398326f99059fF775485246999027B3197955"

amount_in · string · required

Amount to swap in base units (integer string, no decimals)

Example:

"1000000"

Response

200

application/json

Swap quote

estimated_seconds · number

Estimated completion time in seconds (same-chain ~30s, cross-chain varies)

Example:

30

expires_at · integer

Unix timestamp after which this quote should be refreshed

Example:

1720000030

from_amount · string

Input amount in base units

Example:

"1000000"

from_chain · string

Example:

"POL"

from_token · string

platform_fee · string

Fee deducted in base units

Example:

"3000"

to_amount_expected · string

Expected output amount in base units

Example:

"997012"

to_amount_min · string

Minimum output after slippage (0.5% default)

Example:

"992047"

to_chain · string

Example:

"BSC"

to_token · string