# Bitnob API Documentation

> Bitnob provides APIs for Bitcoin, stablecoin (USDT/USDC), and fiat payment infrastructure across Africa. Build payouts, trading, virtual cards, lightning payments, and wallet management into your applications.

## Documentation Sections

- [Getting Started](https://docs.bitnob.co/docs/genesis): Overview, quickstart, and authentication
- [Quickstart](https://docs.bitnob.co/docs/quickstart): Get from zero to first API call
- [Authentication](https://docs.bitnob.co/docs/authentication): HMAC-SHA256 signing and API credentials
- [Stablecoins](https://docs.bitnob.co/docs/stablecoins): USDT and USDC operations
- [Payouts](https://docs.bitnob.co/docs/payouts): Send payments to bank accounts, mobile money, and crypto addresses
- [Card Issuing](https://docs.bitnob.co/docs/card-issuing): Virtual card creation and management
- [Trading](https://docs.bitnob.co/docs/trading): Buy and sell Bitcoin
- [Developer Resources](https://docs.bitnob.co/docs/developer-resources): SDKs, tools, and guides

## API Reference

- [Transactions](https://docs.bitnob.co/api-reference/transactions): Get Transactions, Get Transaction By ID
- [Wallets](https://docs.bitnob.co/api-reference/wallets): Get Wallets, Get Balances
- [Withdrawal](https://docs.bitnob.co/api-reference/withdrawal): Initiate Withdrawal, Finalize Withdrawal
- [Customers](https://docs.bitnob.co/api-reference/customers): Create, Get, Update, Blacklist Customers
- [Addresses](https://docs.bitnob.co/api-reference/addresses): Get, Validate, Generate Blockchain Addresses
- [Virtual Cards](https://docs.bitnob.co/api-reference/virtual-cards): Register User, Create Card, Freeze/Unfreeze, Terminate, Card Transactions
- [Payouts](https://docs.bitnob.co/api-reference/payouts): Quote, Initialize, Finalize, Get Payouts, Supported Countries
- [Trading](https://docs.bitnob.co/api-reference/trading): Initialize Trading, Finalize Trade
- [Lightning](https://docs.bitnob.co/api-reference/lightning): Create Invoice, Initialize Payment, Pay Invoice, Decode Invoice
- [Webhooks](https://docs.bitnob.co/api-reference/webhooks): Event types and webhook configuration
- [Beneficiary](https://docs.bitnob.co/api-reference/beneficiary): Beneficiary management

## Base URLs

- Sandbox: https://api.bitnob.com
- Production: https://api.bitnob.com

## Authentication

All requests require HMAC-SHA256 signature authentication with headers:
- `x-auth-client`: Your Client ID
- `x-auth-timestamp`: Unix timestamp in milliseconds
- `x-auth-nonce`: Unique UUID per request
- `x-auth-signature`: Base64-encoded HMAC-SHA256 signature

## OpenAPI Specification

Available at: https://docs.bitnob.co/api-collections/swagger/openapi.json