What is cNGN?
cNGN is a regulated Naira-backed stablecoin. The cNGN API gives businesses and third-party integrators programmatic access to mint, redeem, transfer, and bridge cNGN across multiple blockchain networks, with fiat on-ramps and off-ramps through Nigerian bank accounts.What you can do with the API
Check balances
Retrieve your cNGN balance across supported networks.
Accept deposits
Collect Naira through dedicated or temporary virtual bank accounts and receive cNGN.
Redeem to fiat
Convert cNGN back to Naira, settled directly to a Nigerian bank account.
Withdraw on-chain
Send cNGN to any whitelisted external wallet address.
Bridge across chains
Move cNGN between supported blockchain networks.
Track transactions
Query your full transaction history with pagination.
Base URL
All API requests are made to:cngn_test or cngn_live) determines whether a request runs against the sandbox or production environment. See Authentication.
Security model
The cNGN API is designed for institutional-grade security. Every integration uses three layers:- API key authentication: a Bearer token identifies your business and environment.
- IP whitelisting: requests are only accepted from IP addresses you have whitelisted in your dashboard.
- Payload encryption: request bodies are encrypted with AES-256-CBC, and response payloads are encrypted to your Ed25519 public key. See the Encryption guide.
SDKs
Official libraries for TypeScript, Python, PHP, and Java handle authentication and payload encryption for you.Libraries & SDKs
Browse the supported libraries and their repositories.
Next steps
1
Get your API keys
Generate test and live API keys from the cNGN merchant dashboard.
2
Follow the Quickstart
Make your first authenticated request in the Quickstart.
3
Set up encryption
Configure request encryption and response decryption in the Encryption guide.
4
Go live
Run through the Going Live Checklist before switching to production keys.