Get off-ramp quote (Solana)

Returns execution parameters and a fiat-credit quote for a Solana USDC deposit, including an optional server-built unsigned VersionedTransaction. Partner-signed request on the partner API base URL. Validate the transaction structure before signing; production callers must pass network mainnet explicitly.

post

/v1/solana/deposit/quote

Authorizations

X-Api-SignaturestringRequired

Partner Auth: EIP-191 signature by the partner's registered backend key, with X-Api-Deadline and optional X-Api-PublicKey headers. See the Signature and verify guide.

Header parameters

X-Api-SignaturestringRequired

Partner's EIP-191 signature (0x-prefixed hex).

X-Api-DeadlinestringRequired

Unix seconds when the request signature expires (within 5 minutes).

X-Api-PublicKeystringOptional

Partner's signer Ethereum address.

Body

urIdinteger · int64Required

User URID.

solanaAddressstringRequired

User's Solana address (Base58); must match the transaction signing key.

usdcAmountstringRequired

Planned USDC input in smallest units (6 decimals). Minimum 5 USDC ("5000000").

outputCurrencystringRequired

Target fiat currency code, e.g. USD.

minUsdcAmountstringOptional

Client-side slippage floor in smallest units. Omit or pass "0" for USDC-only deposits; the on-chain check runs after fee deduction.

networkstringOptional

Solana cluster: mainnet for production, devnet for testing. Defaults to devnet when omitted.

computeUnitPriceinteger · int64Optional

Solana priority fee in micro-lamports per compute unit. Server default 1000.

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 partner API (openapi.ur.app).

codeinteger · int64Required

0 on success; non-zero indicates a business rejection.

messagestringRequired

Human-readable diagnostic; empty on success.

dataanyOptional

Business payload. Shape depends on the endpoint.

post/v1/solana/deposit/quote

POST /v1/solana/deposit/quote HTTP/1.1
Host: openapi.ur.app
X-Api-Signature: text
X-Api-Deadline: text
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "urId": 7537715481,
  "solanaAddress": "9E6fwJhowA1QHwtUXWNF9LnzwE5nXv5AxteaUFErTaeT",
  "usdcAmount": "10000000",
  "outputCurrency": "USD",
  "network": "mainnet"
}

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.

{
  "code": 0,
  "message": "",
  "data": {
    "network": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "programId": "DgiyAgiEJDt4hXw56mpKDd7mcYRYUaxrKg3ConyeupYX",
    "usdcMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "nativeFeeLamports": "5000000",
    "nativeFeeLamportsWithBuffer": "6000000",
    "rules": {
      "onlyUsdc": true,
      "feePayerMustBeUser": true
    },
    "transaction": "AQAAAA...base64...",
    "lastValidBlockHeight": 412280000,
    "outputAmount": "9.9",
    "processingFee": "0.1"
  }
}