On-ramp to crypto

This quickstart walks you through your first fiat-to-crypto conversion. For detailed implementation, see the full Ramps documentation.

Overview

Grid’s Ramps API enables seamless conversion between fiat and cryptocurrency. In this quickstart, you’ll:

Set up your platform
Complete user KYC
Link a funding source
Execute a conversion

Prerequisites

A Grid API key (request sandbox access)
Basic understanding of REST APIs

Step 1: Platform Configuration

Configure your platform for ramp operations.

Platform Configuration

Learn how to configure your platform for ramps

Step 2: User Onboarding & KYC

Create a customer and complete KYC verification.

curl -X POST https://api.lightspark.com/grid/2025-10-13/customers \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "jane@example.com",
    "kyc_level": "basic"
  }'

Step 3: Link Funding Source

Connect a bank account or other funding source.

Plaid Integration

Link bank accounts via Plaid

External Accounts

Manual bank account setup

Step 4: Execute Conversion

Convert fiat to crypto.

# Get a conversion quote
curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "USD",
    "destination_currency": "BTC",
    "amount": "100.00"
  }'

# Execute the conversion
curl -X POST https://api.lightspark.com/grid/2025-10-13/conversions \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "QUOTE_ID",
    "destination_wallet": "bc1q..."
  }'