---
title: "Get on-ramp quote"
method: POST
path: "/api/v1/quote/onramp"
tags: ["External Wallet Access Mode"]
---

# Get on-ramp quote

`POST /api/v1/quote/onramp`

On-ramp is not yet generally available; this endpoint is documented for preview only. Returns a quote for scene onramp (fiat token to destination token) or scene swap_retry (retry a failed destination swap). When needLiveness is true, the user must pass liveness before submitting.

## Headers

- `tokenId` string, required
- `network` string, required
- `sign` string, required
- `hash` string, required
- `deadline` string, required

## Request body

- object
  - `scene` 'onramp' | 'swap_retry', required — onramp for the main flow; swap_retry for retrying a failed swap leg.
  - `srcChainId` string, required — Source chain ID (CAIP-2).
  - `dstChainId` string, required — Destination chain ID (CAIP-2).
  - `fromToken` string, required — Fiat token contract address.
  - `toToken` string, required — Destination token address.
  - `amount` string, required — Input amount in smallest units (e.g. "10000" is 100 USD).
  - `slippageBps` integer — Slippage tolerance in basis points.

## Response `200`

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

- EwaEnvelope — Standard response envelope for the user API (api.ur.app).
  - `retCode` integer, required — 0 on success; non-zero indicates failure.
  - `retMsg` string, required — Human-readable message; error details when retCode is non-zero.
  - `result` unknown
  - `timeNow` integer — Server timestamp in milliseconds.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)