Skip to main content
GET
/
v0
/
ramp
/
quotes
Get ramp quotes
curl --request GET \
  --url https://api.sumvin.com/v0/ramp/quotes \
  --header 'x-juno-jwt: <api-key>'
{
  "_links": {},
  "quotes": [
    {
      "from_asset": "<string>",
      "to_asset": "<string>",
      "source_amount": "<string>",
      "chain_id": 123,
      "destination_amount": "<string>",
      "exchange_rate": 123,
      "total_fee": "<string>",
      "network_fee": "<string>",
      "transaction_fee": "<string>",
      "partner_fee": "<string>",
      "payment_method_type": "<string>",
      "service_provider": "<string>",
      "country_code": "<string>",
      "ramp_score": 123,
      "low_kyc": true,
      "is_swap": false
    }
  ]
}

Authorizations

​
x-juno-jwt
string
header
required

JWT issued by Dynamic Labs or Privy. Sent in the x-juno-jwt header on every authenticated request.

Headers

​
x-juno-orgid
string | null

Tenant org ID for multi-tenant auth

​
x-juno-jwt
string | null
​
x-sumvin-token
string | null
​
x-sumvin-pat
string | null
​
x-sumvin-pint-token
string | null
​
X-Timestamp-Format
string

Controls how timestamp fields are serialized in JSON response bodies.

Default (header omitted or any other value): epoch milliseconds as integers. iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.

Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".

Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.

Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.

Example:

"iso8601"

Query Parameters

​
source_amount
required

Amount of from_asset the user is selling. Must be greater than zero.

Required range: x > 0
Example:

"100"

​
from_asset
string
required

Asset.symbol value the user is paying with. Fiat ISO 4217 (e.g. USD) for buys, or a crypto symbol (e.g. USDC) for sells.

Examples:

"USD"

"EUR"

"USDC"

​
to_asset
string
required

Asset.symbol value the user is receiving. Crypto for buys, fiat for sells.

Examples:

"USDC"

"ETH"

"USD"

​
chain_id
enum<integer>
required

EIP-155 chain id of the crypto leg.

Available options:
1,
10,
137,
42161,
8453,
43114,
56,
1328,
1329
Examples:

1

137

8453

​
country_code
enum<string>
default:US

User's country (ISO 3166-1 alpha-2). Filters quotes to providers live in that market.

Available options:
US,
CA,
MX,
BR,
AR,
CL,
CO,
PE,
GB,
DE,
FR,
IT,
ES,
NL,
BE,
IE,
PT,
AT,
CH,
SE,
NO,
DK,
FI,
PL,
CZ,
GR,
SG,
HK,
JP,
KR,
AU,
NZ,
IN,
TH,
PH,
MY,
ID,
AE,
SA,
IL,
TR,
ZA,
NG
​
payment_method_type
enum<string> | null

Restrict quotes to one rail. Omit to let the provider rank the full set.

Available options:
CARD,
CREDIT_DEBIT_CARD,
VISA,
MASTERCARD,
ACH,
SEPA,
BACS,
BANK_TRANSFER,
LOCAL_BANK_TRANSFER,
LOCAL,
PIX,
MOBILE_WALLET,
APPLE_PAY,
GOOGLE_PAY,
SAMSUNG_PAY
​
reusable_identity_only
boolean
default:false

When true, return only providers that accept the user's existing verified identity, so they can complete the trade without repeating identity verification. Defaults to false (all providers).

​
used_before_only
boolean
default:false

When true, return only providers the user has previously transacted with. If the user has no prior ramp transactions, the result is empty. Defaults to false (all providers).

Response

Successful Response

​
_links
Links · object
required

HAL-style hypermedia links for navigation and available actions.

​
quotes
QuoteData · object[]
required

Ranked quotes from supported providers for the requested trade.