Swap provider

Set up a swap provider

Allow purchasers to pay with USDT, USDC, ETH, or SOL. The swap provider securely converts the amount to Bitcoin Lightning.

Create API credentials with a recommended provider below, or build your own, then add them to your openreceive.yml.

Recommended

Lightning Swap

Lightning Swap is a lightning-native swap service. Create one API key in the dashboard, then add the key and secret to openreceive.yml.

Lightning Swap API keys page with Create key form — Enter a label, then tap **Create key**.

Lightning Swap API key detail showing openreceive.yml snippet — Copy the YAML block and paste it into your **openreceive.yml**.

Go to lightning-swap.com and tap Sign in for API keys.
Sign in, then open the API keys page.
Enter a label and tap Create key.
Copy the generated YAML into your openreceive.yml under swap.providers.

Recommended

FixedFloat

Create one API key in Account settings, then add the key and secret to openreceive.yml.

FixedFloat Generate API Key page with Generate button highlighted — Tap **Generate** to create your API key.

Go to ff.io and sign in.
Open Account, then choose API management.
Tap Generate. FixedFloat allows one API key per account.
Copy the API key and secret into your openreceive.yml:

openreceive.yml

swap:
  providers:
    - base_url: https://ff.io/
      key: "YOUR_FIXEDFLOAT_API_KEY"
      secret: "YOUR_FIXEDFLOAT_API_SECRET"

Advanced

Build your own

Build your own altcoin → Lightning swap provider by conforming to the Lightning Swap API, which is a subset of the FixedFloat API.

Point OpenReceive at your service the same way you would Lightning Swap or FixedFloat: set base_url, key, and secret under swap.providers in openreceive.yml.

Read Lightning Swap API docs