๐Ÿ”Œ Integration - Getting started

Integrate Bitcoin Lightning functionality provided by the Alby Wallet into your applications, with the Alby Wallet API. Send & receive payments, create invoices, access Podcasting 2.0 and more!

Welcome to the Alby Wallet API Integration Guide, your resource for integrating Bitcoin Lightning into your applications. This allows you to easily add bitcoin lightning with Alby API to your application. You can send and receive payments, get podcasting 2.0 details, create invoices, retrieve the user's incoming and outgoing payments, and make Lightning payments on behalf of users.

To test out the API using the Postman web client, check out our Postman workspace: https://www.postman.com/getalby/workspace/alby-workspace/. To use this workspace in the browser, please fork it and use an access token from https://getalby.com/developer to test it out. If you have any issues, please let us know on telegram.

Alby API Endpoint

All of the examples in this guide will use the production endpoint. Please be aware that you will be spending real sats when paying any invoice generated by this API.



  1. See the Authorization page on how to obtain an access token

  2. Make a request using the access token in the Authorization header:

curl https://api.getalby.com/balance -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

You should now see a JSON response like that:

  "balance": 1000,
  "currency": "BTC",
  "unit": "sat"
  1. Make sure to always send payloads as JSON and include a content-type header (Content-Type: application/json)

Alby Packages

  • Alby JS SDK - Typescript package to integrate Alby Wallet API and NWC

  • Alby PHP - PHP library to integrate the Alby Wallet API

Community Packages

  • pyalby - Python library to integrate the Alby Wallet API

  • AlbyKit - Swift SDK to integrate the Alby Wallet API

Check out the Alby developer portal for a full overview of Alby's supported tools, APIs and packages to add lightning to your app.

Last updated


Your bitcoin & nostr companion / from ๐Ÿ with ๐Ÿงก