> ## Documentation Index
> Fetch the complete documentation index at: https://agents-docs.lightspark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ramps

![Ramps hero](https://mintcdn.com/agents-docs/qL8kqlSYbvexR8cg/images/heroes/hero-ramps.jpg?fit=max\&auto=format\&n=qL8kqlSYbvexR8cg\&q=85\&s=34dd43731898a1813a2c2fe317bdd9e8)

With Grid, you can seamlessly convert between fiat currencies and cryptocurrencies through a single, simple API. The Grid automatically handles currency conversion, compliance, and instant settlement via the Lightning Network.

![](https://agents-docs.lightspark.com/images/icons/lightning.svg)

Instant Conversion

Convert fiat to crypto (on-ramp) or crypto to fiat (off-ramp) in seconds using real-time exchange rates.

![](https://agents-docs.lightspark.com/images/icons/shield.svg)

Simplified Infrastructure

Grid handles the conversion and settlement process, reducing complexity in your crypto integration.

![](https://agents-docs.lightspark.com/images/icons/globe.svg)

Global Settlement

Leverages the Lightning Network for instant Bitcoin transfers and local banking rails for fiat settlement worldwide.

***

## How Ramps Work

**1. Quote Creation**

Get real-time exchange rates and payment instructions for your desired
conversion (fiat → crypto or crypto → fiat).

**2. Funding & Conversion**

Fund the quote using the provided payment instructions. Grid executes the
conversion at the quoted rate.

**3. Settlement**

Receive your converted funds via Lightning Network (for crypto) or local
banking rails (for fiat) within seconds.

***

## Grid Features

Users interact with Grid through two main interfaces:

> [tab] API
>
> Programmatic access to create quotes, fund conversions, execute transfers,
> and reconcile all activity with real-time webhooks.

> [tab] Dashboard
>
> Your development and operations team can use the dashboard to monitor
> conversions, manage API keys and environments, and troubleshoot with
> detailed logs.

### On-Ramp: Fiat to Crypto

Convert fiat currency to cryptocurrency and deliver it to self-custody wallets.

* **Create quotes** to lock exchange rates for fiat-to-crypto conversions
* **Payment instructions** guide users on how to fund their conversion
* **Instant delivery** to Spark wallets or other supported crypto destinations
* **Webhook notifications** confirm successful conversion and delivery

### Off-Ramp: Crypto to Fiat

Convert cryptocurrency to fiat currency and deliver it to bank accounts.

* **Pre-funded accounts** hold crypto balances for conversion
* **Real-time rates** for crypto-to-fiat exchange
* **Bank account delivery** via local payment rails
* **Compliance** handled automatically through Grid's infrastructure

### Funding Options

Grid supports multiple funding models for on-ramps and off-ramps:

* **Just-in-time (JIT)**: Create a quote and fund it in real-time using payment instructions (ideal for on-ramps)
* **Pre-funded accounts**: Maintain balances in crypto or fiat and convert from those balances (ideal for off-ramps)

> [!TIP]
>
> You can mix funding models based on your use case. On-ramps typically use JIT
> funding, while off-ramps use pre-funded accounts.

### Environments

> [!NOTE]
>
> Grid supports two environments: **Sandbox** and **Production**.
>
> The Sandbox mirrors production behavior, allowing you to test the full end-to-end flow—from creating quotes and simulating funding to executing conversions and receiving webhooks—without moving real funds.
>
> The Production environment uses live credentials and base URLs for real transactions once you're ready to launch.

***

![](https://agents-docs.lightspark.com/images/icons/light-bulb.svg)

Get Started

Ready to integrate Grid? Check out our quickstart guide.

[Open](https://agents-docs.lightspark.com/ramps/quickstart.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.