Send Bitcoin rewards

This quickstart walks you through sending your first Bitcoin reward. For detailed implementation, see the full Rewards documentation.

Overview

Grid’s Rewards API enables you to send micro-payments and Bitcoin rewards at scale. In this quickstart, you’ll:

Set up your platform
Create a rewards pool
Send your first reward

Prerequisites

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

Step 1: Platform Configuration

Configure your platform for rewards distribution.

Platform Configuration

Learn how to configure your platform for rewards

Step 2: Create Internal Account

Set up an internal account to fund rewards.

curl -X POST https://api.lightspark.com/grid/2025-10-13/internal-accounts \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "BTC",
    "name": "Rewards Pool"
  }'

Step 3: Send a Reward

Distribute Bitcoin to a recipient.

curl -X POST https://api.lightspark.com/grid/2025-10-13/rewards \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_sats": 1000,
    "recipient_wallet": "bc1q...",
    "memo": "Cashback reward"
  }'