View docsLog inContact

Wallets

Self-custody wallets embedded in your product. Lightspark provisions a wallet per user; only their device can authorize funds out.

View docsBook a demo

Lightspark API

(0, 0, 0)

Capabilities / Wallets

Every user gets a self-custody wallet under your brand. They hold the keys; only their device can move funds out. Swipe to explore.

Pan and zoom to explore

Technical specs

01

Overview

Give every user a self-custody wallet under your brand. The Lightspark API provisions an embedded Spark wallet per customer that holds stablecoin and BTC balances. Incoming funds credit automatically; outgoing transfers require a signature from the user's device.

02

Custody

  • KeysUsers hold their own keys. Neither Lightspark nor your platform can move their funds
  • Outbound transfersSigned on the user’s device; funds release only with a valid signature
  • Incoming fundsCredit automatically; no approval needed to receive
  • Wallet exportUsers can export their wallet seed and take it anywhere
03

Authentication

  • CredentialsPasskeys, OIDC (Google, Apple, or your own IdP), or email OTP
  • SessionsShort-lived session signing keys, 15 minutes by default
  • Device bindingKeys are sealed to the user’s device; signatures can’t be replayed elsewhere or after expiry
04

Balances

  • AssetsStablecoin (USDB by default) and BTC
  • NetworkSpark, a Lightning-compatible Bitcoin L2 with instant, low-fee transfers
05

Funding & withdrawals

  • FundingFund from fiat rails or crypto; balances credit the moment funds arrive
  • WithdrawalsCash out to local bank rails in 65+ countries: PIX, UPI, SEPA, ACH, and more
  • External walletsRegister users’ own Spark wallets as external accounts for direct delivery
06

API

  • One integrationWallets use the same quotes, transactions, and webhooks as payouts and deposits; no second integration
  • ProtocolREST, OpenAPI 3.1
  • SDKsTypeScript, Kotlin
  • AuthHTTP Basic (server-side), Passkeys / OIDC / Email OTP (end-user)
  • Money movementQuote → execute → webhook. Same flow for every rail, every currency.
  • SigningECDSA P-256, device-held keys, per-action payloadToSign
  • IdempotencyIETF-spec Idempotency-Key on every mutation
  • WebhooksSigned payloads, exponential retry, deduplicate by delivery ID
View docs
07

Integration

  • Time to launchWeeks
  • BrandingYour brand and product surface
  • EconomicsReserve rewards, card interchange, FX margin, and transaction fees accrue to the platform
  • ComplianceLightspark MSB, hosted KYC/KYB, or bring your own
  • PricingCustom
Contact sales