Sign in
latestOpenAPI 3.1.02026-08-108094177.6 KB

087dcf516ce2

Managed Custody Mode

Retry on-ramp swap

Redo the swap leg of an On-ramp whose bridge succeeded but whose swap failed. Only call this endpoint when the pending-retry endpoint returns a pending item, and use a fresh quote with scene swap_retry. The transaction webhook reports the final result. On-ramp is not yet available for integration; this reference is a preview.

post/api/fma/v1/onramp-swap

Headers

X-Api-Signaturestring required

0x-prefixed 65-byte hex EIP-191 signature over the Partner Auth message. See the Signature and verify guide.

X-Api-Deadlinestring required

Unix seconds. UR rejects the request when the current time is past the deadline. Keep the validity window at or under 5 minutes.

X-Api-PublicKeystring required

0x-prefixed partner signer address registered with UR.

X-Ur-Idstring

Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.

X-External-User-Idstring

Send at least one of X-Ur-Id or X-External-User-Id. When both are present, UR resolves the user by X-Ur-Id first.

Request body

reqIdstring required

Partner-supplied idempotency key. Keep it stable across retries of the same logical operation.

quoteIdstring required

quoteId from a fresh quote with scene swap_retry.

chainIdstring required

Destination chain ID in CAIP-2 format, from the pending retry.

originalTxHashstring required

Original On-ramp transaction hash, from the pending retry.

usdcAmountstring required

Stuck USDC amount in smallest units (pending retry amountRaw).

tokenOutstring required

Destination token address (pending retry toToken).

minAmountOutstring required

best.minAmountOut from the retry quote.

aggregatorstring required

best.to from the retry quote (not best.aggregator).

swapCalldatastring required

best.swapCalldata from the retry quote.

Response

Standard envelope. Business errors return HTTP 200 with a non-zero code.

codeinteger required

0 on success; non-zero business error code.

messagestring required

Human-readable explanation. May be empty on success.