Introduction to the Bitnob APIs

Bitnob is financial infrastructure for bitcoin, stablecoins, and local currency rails across Africa. You build on it through one of two APIs:

	Bitnob Business API	Bitnob Enterprise API
What it is	Bitnob holds the balance and settles payouts, cards, trades, and deposits for you.	Non-custodial wallets with policy-governed signing across chains.
Base URL	`https://api.bitnob.com`	`https://api.platform.bitnob.com`
Authentication	HMAC-signed requests	An `X-API-Key` header

Not sure which you need? Choose a product compares them in more detail.

Get started

Both APIs start from the same Bitnob account. Set it up once, then follow the quickstart for the API you’re using.

1. Set up your account

2a. Business API quickstart

Sign a request and get a 200 back, in about five minutes.

2b. Bitnob Enterprise API quickstart

Confirm your key, list chains, and create your first wallet.

What you can build with the Bitnob Business API

Each product has its own guides and endpoints. Most integrations use two or three.

Bitcoin

On-chain and Lightning wallets. Custodial by default, with non-custodial options.

Stablecoins

Issue addresses and move USDT and USDC across multiple chains.

Trading

Quote and execute conversions between BTC, USDT, USDC, and NGN.

Payouts

Pay out to bank accounts and mobile money wallets.

Card issuing

Issue and fund USD virtual Visa cards on demand.

Virtual accounts

Give each customer a dedicated Nigerian bank account number for NGN deposits.

What you can build with the Bitnob Enterprise API

Wallets and signing

Vaults, wallets, and addresses across chains, with every signature checked against your policies.

Bitcoin with your own keys

Business-managed custody and self-custodial wallets on Bitnob’s infrastructure.

A typical Business API integration

Most Business API products follow the same shape, so learning one carries over to the rest.

Create a customer

Cards and most virtual accounts belong to a customer. Balances belong to your account.

Fund a balance

Receive bitcoin or stablecoins to an issued address, or take NGN through a virtual account.

Quote, then execute

Conversions and payouts are quoted first. A quote is only valid for a limited window.

Confirm with a webhook

Money movement settles asynchronously. Treat the webhook as the source of truth, not the API response.

Where to go next

Send your first payout

From quote to confirmed delivery, with real requests and responses.

API reference

Every Business API and Bitnob Enterprise API endpoint, with request and response schemas.

Why we built this

The problem Bitnob exists to solve.

​Get started