---
title: "Create on-ramp request"
method: POST
path: "/v1/onramp"
tags: ["Delegated Contract Mode"]
---

# Create on-ramp request

`POST /v1/onramp`

Delegated Contract Mode will be deprecated soon; new partners should use Managed Custody Mode. On-ramp is not yet generally available; this endpoint is documented for preview only. Exchanges a fiat token to USDC and optionally performs a swap or bridge to the target token based on the quote from /v1/onramp/quote. Omit the dst* fields to perform fiat to USDC only.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string

## Request body

- object
  - `quoteId` string, required — Quote ID from /v1/onramp/quote.
  - `requestId` string, required — Idempotency key; reuse on retry.
  - `urId` integer, required — UR user ID.
  - `tokenIn` string, required — Fiat token symbol from /v1/tokens.
  - `amountIn` string, required — Input amount in smallest units. After conversion, must be at least 5 USDC.
  - `withdrawAddress` string — User-specified withdrawal address for the on-ramp.
  - `chainId` string — Source chain ID (currently Mantle only).
  - `dstChainId` string — Destination chain ID for the bridge or swap.
  - `dstAggregator` string — Aggregator contract address from best.aggregator in the quote.
  - `dstTokenOut` string — Destination token symbol.
  - `dstSwapCalldata` string — best.swapCalldata from the quote.
  - `dstMinAmountOut` string — Minimum acceptable amount in smallest units, from best.minUsdcAmount.

## 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.

- DcEnvelope — Standard response envelope for the partner API (openapi.ur.app).
  - `code` integer, required — 0 on success; non-zero indicates a business rejection.
  - `message` string, required — Human-readable diagnostic; empty on success.
  - `data` unknown

---

[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)