> ## Documentation Index > Fetch the complete documentation index at: https://docs.sumvin.com/llms.txt > Use this file to discover all available pages before exploring further. # Use Sigil to instant on-ramp > Quote a buy, open a hosted ramp session, and settle crypto into a user's wallet. At the end of this page, you will have moved fiat to crypto for a Sumvin user — the ramp is part of **Atomic Money**, Sumvin's payments, ramps, cards, and settlement layer. The ramp transaction reaches `completed`, and the destination wallet holds the new balance. The final read: * [`GET /v0/ramp/transactions/{transaction_id}`](/api-reference/ramp/get-a-ramp-transaction) — Fetch the settled ramp transaction. ## Prerequisites * A KYC-verified Sumvin user with a deployed Safe. Run [Stand up an account](/guides/quickstarts/stand-up-account) first if you do not have one. * A Platform API JWT and your `x-juno-orgid` header — see [Authentication](/authentication). * Base URL `https://api.sumvin.com/v0`. * Sandbox test card details — available from your account manager for non-production flows. The user does not re-verify inside the Meld widget. Sumvin shares their existing KYC outcome with Meld on the first ramp call. See [KYC passthrough](/products/ramps/kyc-passthrough). Quote what an amount of fiat will buy. You send the triplet `from_asset`, `to_asset`, `chain_id` — direction is inferred from which side is fiat. The response ranks live quotes from the service providers that serve the user's country and payment method, with fees, exchange rate, and the destination amount broken out. [`GET /v0/ramp/quotes`](/api-reference/ramp/get-ramp-quotes) — List ramp quotes. ```bash curl theme={null} curl "https://api.sumvin.com/v0/ramp/quotes?source_amount=100&from_asset=USD&to_asset=SEI&chain_id=1329&country_code=US" \ -H "x-juno-jwt: " \ -H "x-juno-orgid: " ``` ```typescript TypeScript theme={null} const params = new URLSearchParams({ source_amount: "100", from_asset: "USD", to_asset: "SEI", chain_id: "1329", country_code: "US", }); const res = await fetch( `https://api.sumvin.com/v0/ramp/quotes?${params}`, { headers: { "x-juno-jwt": process.env.SUMVIN_JWT!, "x-juno-orgid": process.env.SUMVIN_ORG_ID!, }, }, ); const { quotes } = await res.json(); ``` ```python Python theme={null} import httpx import os res = httpx.get( "https://api.sumvin.com/v0/ramp/quotes", headers={ "x-juno-jwt": os.environ["SUMVIN_JWT"], "x-juno-orgid": os.environ["SUMVIN_ORG_ID"], }, params={ "source_amount": "100", "from_asset": "USD", "to_asset": "SEI", "chain_id": 1329, "country_code": "US", }, ) quotes = res.json()["quotes"] ``` **Response:** `200 OK` ```json theme={null} { "quotes": [ { "from_asset": "USD", "to_asset": "SEI", "chain_id": 1329, "source_amount": "100", "destination_amount": "99.85", "exchange_rate": 1.0015, "total_fee": "2.49", "network_fee": "0.25", "transaction_fee": "2.24", "partner_fee": "0.00", "payment_method_type": "CREDIT_DEBIT_CARD", "service_provider": "MOONPAY", "country_code": "US", "ramp_score": 87, "low_kyc": false, "is_swap": false } ], "_links": { "self": { "href": "/v0/ramp/quotes" }, "sessions": { "href": "/v0/ramp/sessions", "method": "POST" } } } ``` Quotes carry a `ramp_score` — higher means a better combined rate, fee, and success likelihood. Narrow the list by passing `payment_method_type` if you want a single rail (`CREDIT_DEBIT_CARD`, `ACH`, `SEPA`, `APPLE_PAY`, `GOOGLE_PAY`, `BANK_TRANSFER`, `LOCAL_BANK_TRANSFER`, `BACS`). `chain_id` always describes the crypto leg. Discover the rampable `(symbol, chain_id)` pairs in [Supported values](/products/ramps/supported-values#crypto--rampable-today) — `SEI` on Sei (`1329`) is the first launch chain; `ETH`, `USDC`, and `EURC` on Base (`8453`) are also live today. Take the quote the user selected and create a session. The session returns a hosted widget URL — that is what the user opens to pay. Pass `wallet_address` as the settlement destination. Crypto lands there when the transaction settles. [`POST /v0/ramp/sessions`](/api-reference/ramp/open-a-ramp-widget-session) — Create a ramp session. ```bash curl theme={null} curl -X POST https://api.sumvin.com/v0/ramp/sessions \ -H "x-juno-jwt: " \ -H "x-juno-orgid: " \ -H "Content-Type: application/json" \ -d '{ "source_amount": "100", "from_asset": "USD", "to_asset": "SEI", "chain_id": 1329, "wallet_address": "0x9f8e7d6c5b4a39281726354091827364501928a7", "country_code": "US", "payment_method_type": "CREDIT_DEBIT_CARD", "service_provider": "MOONPAY" }' ``` ```typescript TypeScript theme={null} const res = await fetch("https://api.sumvin.com/v0/ramp/sessions", { method: "POST", headers: { "x-juno-jwt": process.env.SUMVIN_JWT!, "x-juno-orgid": process.env.SUMVIN_ORG_ID!, "Content-Type": "application/json", }, body: JSON.stringify({ source_amount: "100", from_asset: "USD", to_asset: "SEI", chain_id: 1329, wallet_address: "0x9f8e7d6c5b4a39281726354091827364501928a7", country_code: "US", payment_method_type: "CREDIT_DEBIT_CARD", service_provider: "MOONPAY", }), }); const { session } = await res.json(); ``` ```python Python theme={null} import httpx import os res = httpx.post( "https://api.sumvin.com/v0/ramp/sessions", headers={ "x-juno-jwt": os.environ["SUMVIN_JWT"], "x-juno-orgid": os.environ["SUMVIN_ORG_ID"], }, json={ "source_amount": "100", "from_asset": "USD", "to_asset": "SEI", "chain_id": 1329, "wallet_address": "0x9f8e7d6c5b4a39281726354091827364501928a7", "country_code": "US", "payment_method_type": "CREDIT_DEBIT_CARD", "service_provider": "MOONPAY", }, ) session = res.json()["session"] ``` **Response:** `201 Created` ```json theme={null} { "session": { "id": "ses_7b3e21", "widget_url": "https://widget.meld.io/?token=...", "service_provider_widget_url": "https://buy.moonpay.com/...", "token": "eyJhbGciOiJSUzI1NiJ9...", "external_session_id": "b2b8f5a0-4e9f-4f7a-9d2c-1a3e5b7c9d0e" }, "_links": { "self": { "href": "/v0/ramp/sessions", "method": "POST" }, "quotes": { "href": "/v0/ramp/quotes" }, "transactions": { "href": "/v0/ramp/transactions" } } } ``` `403 Forbidden` on this call means the user has not completed KYC. Check `GET /v0/kyc/status` and route the user through [KYC](/guides/kyc) before retrying. Navigate the user to `widget_url`. Render it in an iframe, a popup, or as a full-page redirect — whichever matches your UX. ```typescript theme={null} // Redirect approach window.location.href = session.widget_url; // iframe approach