Get off-ramp quote (EVM)

Returns the best aggregator quote for an EVM crypto deposit into fiat, including network and cross-chain fees. Quotes are cached for 60 seconds. Pass best.to, best.swapCalldata, and best.minUsdcAmount to the Off-ramp contract's depositTokenViaAggregator call.

post

/api/v1/partner/quote/deposit

Header parameters

tokenIdstringRequired

The user's URID (NFT token id).

Body

chainIdstringRequired

Source chain ID (CAIP-2), e.g. eip155:1.

userAddressstringRequired

User wallet address used to build the route.

fromTokenstringRequired

Source token address. Use the zero address for native tokens.

toTokenstringRequired

Target fiat token contract address.

amountstringRequired

Deposit amount in the token's smallest unit.

Responses

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.

application/json

Standard response envelope for the user API (api.ur.app).

retCodeinteger · int64Required

0 on success; non-zero indicates failure.

retMsgstringRequired

Human-readable message; error details when retCode is non-zero.

resultanyOptional

Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string.

timeNowinteger · int64Optional

Server timestamp in milliseconds.

post/api/v1/partner/quote/deposit

POST /api/v1/partner/quote/deposit HTTP/1.1
Host: api.ur.app
tokenId: text
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "chainId": "eip155:42161",
  "userAddress": "0xYourWalletAddress",
  "fromToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "toToken": "USD",
  "amount": "1000000000"
}

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.

{
  "retCode": 0,
  "retMsg": "",
  "result": {
    "quoteId": "ur_1772002152589294701",
    "chainId": "eip155:84532",
    "best": {
      "aggregator": "ur",
      "to": "0x0000000000000000000000000000000000000000",
      "swapCalldata": "0x",
      "minUsdcAmount": "4950000",
      "expectedUsdcAmount": "5000000",
      "slippageBps": 50,
      "deadline": 1772002211,
      "priceImpact": "0"
    },
    "inputAmount": "5000000",
    "outputAmount": "5",
    "exchangeRate": "1",
    "crossChainFee": "111598233453575",
    "networkFee": "3109867200000"
  },
  "timeNow": 1772002152589
}