Execute a swap

Executes a token swap from the customer’s WaaS wallet. The routing (on-chain DEX vs cross-chain bridge) is determined automatically — the merchant does not need to know or specify how the swap is fulfilled.

Flow:

1. Call GET /api/v1/swap/quote to preview the output amounts
2. Call this endpoint with amount_out_min set to your slippage floor (from to_amount_min in the quote)
3. Check GET /api/v1/swap/customer/{customerID}/history or the merchant dashboard for status

The customer wallet must exist (created via POST /api/v1/wallet/customers) and hold sufficient balance to cover the swap amount plus gas.

POST /api/v1/swap/customer/{customerID}

Execute a swap

cURL

curl --request POST \
  --url https://api.rach.finance/api/v1/swap/customer/{customerID} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount_in": "1000000",
  "from_chain": "POL",
  "from_token": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  "to_chain": "BSC",
  "to_token": "0x55d398326f99059fF775485246999027B3197955",
  "amount_out_min": "992047"
}
'

200

{
  "status": "pending",
  "tx_hash": "0xabc123..."
}

Authorizations

X-API-Key · string · header · required

Business API key for server-to-server integrations. Key prefix determines the environment — no separate flag needed: test_sk_* = sandbox/testnet, live_sk_* = production/mainnet.

Path Parameters

customerID · string · required

Your internal customer identifier (same value used when creating the wallet)

Body

application/json

amount_in · string · required

Amount to swap in base units (integer string)

Example:

"1000000"

from_chain · string · required

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

Example:

"POL"

from_token · string · required

Token address on source chain, or "native"

Example:

"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"

to_chain · string · required

Destination chain

Example:

"BSC"

to_token · string · required

Token address on destination chain, or "native"

Example:

"0x55d398326f99059fF775485246999027B3197955"

amount_out_min · string

Minimum acceptable output in base units. Use to_amount_min from the quote. Omitting this removes slippage protection — always set it in production.

Example:

"992047"

Response

200

application/json

Swap submitted. The transaction is now on-chain.

status · enum<string>

Available options: pending

Example:

"pending"

tx_hash · string

On-chain transaction hash

Example:

"0xabc123..."