Off ramp API: convert crypto to naira for your users.
Issue a deposit wallet to any of your users.
# Issue a deposit wallet for user_8841
POST /v1/wallets
{ "customer_ref": "user_8841", "asset": "USDT", "network": "TRC20" }201 Created
{ "id": "wal_01JXK4N9Q2M7", "address": "TWd2yzw5yFc9C3jn…", "status": "active" } Webhooks, signed with your secret
-
deposit.detected150.000000 USDT txid b2a4c9f7… -
deposit.confirmedrate locked ₦1,621.50 ngn_amount 243,225.00 -
settlement.paidnet_ngn 242,495.32 NIP/260706/094147/8823
- Base URL
- api.monica.cash/v1
- Format
- JSON over HTTPS
- Auth
- Bearer keys HMAC webhooks
- Fee
- 0.3% capped at $5
When their crypto confirms on the network, Monica converts it at the locked rate and settles naira to your corporate account within 60 seconds of confirmation. A signed webhook tells your system every step.
Four events. One naira settlement.
Every deposit walks the same path, and every step is an event your system receives. There is nothing to poll.
-
POST /v1/walletsYou issue a wallet.
Call it with your user's reference and get back a permanent deposit address for the asset and network you chose. -
deposit.detectedTheir deposit is seen.
The moment a transaction touches the address you receive the txid and amount, before it even confirms. -
deposit.confirmedConfirmation locks the rate.
On the required confirmation the naira rate is locked and the exact naira value is on the event. Safe to credit your user. -
settlement.paidNaira lands in your account.
Paid to your registered corporate bank account within 60 seconds of the network confirming, with the bank reference.
Everything around the conversion is free.
You pay one fee, and only when a deposit converts. Wallets, webhooks, rates and the sandbox cost nothing at any scale.
-
Deposit wallets per user.
One permanent address per asset and network for each of your users. Repeat calls with the same
customer_refreturn the same wallet.Free
-
Signed webhooks.
Every event is a POST with an HMAC signature and timestamp you verify. Failed deliveries retry with backoff for 24 hours.
Free
-
Rates endpoint.
GET /v1/ratesreturns the current naira rate for every supported asset. The binding rate is always the one locked at confirmation. Need rates without a key? Use the free public rates feed.Free
-
Full sandbox.
The same API at
sandbox.api.monica.cash/v1with yoursk_test_key and testnet coins, before any review.Free
-
Settlement to your account.
Converted naira is paid to your registered corporate bank account within 60 seconds of the network confirming, bank reference included.
0.3% · capped at $5
-
Exact reconciliation.
Reconcile by
customer_ref,deposit_idorsettlement_id. Every fee is itemised asfee_ngnon the deposit and the settlement.Built in
0.3%
Capped at $5 per transaction, deducted before settlement
- No setup fee
- No monthly minimum
- No charge for wallets, webhooks or the sandbox
You only pay when a deposit converts to naira. The cap means your effective rate falls as transactions grow, and every fee is itemised as fee_ngn so reconciliation is exact.
The cap in practice.
The fee is 0.3% until the $5 cap takes over at $1,666.67. After that, the bigger the transaction, the smaller your effective rate.
| Transaction | API fee | Effective |
|---|---|---|
| $100 | $0.30 | 0.30% |
| $500 | $1.50 | 0.30% |
| $1,666.67 | $5.00 | cap starts |
| $5,000 | $5.00 | 0.10% |
| $20,000 | $5.00 | 0.025% |
| $100,000 | $5.00 | 0.005% |
Built for businesses that receive crypto and run on naira.
-
Apps and marketplaces
A deposit address for every user.
Issue a wallet per user, show the address in your own product, and credit their ledger the moment
deposit.confirmedarrives with the exact naira value.- Permanent addresses, one per asset and network
- Your own user IDs echoed on every event
- Seven assets: BTC, USDT, USDC, ETH, SOL, TRX, BNB
-
Payments and remittance
Stablecoins in, naira out, under a minute.
Receive USDT or USDC from abroad on the networks your senders already use, and have naira settled to your corporate account within 60 seconds of confirmation.
- TRC20, ERC20, BEP20, SPL and Bitcoin networks
- Rate locked at confirmation, never a surprise
- Bank reference on every settlement
-
Finance and treasury teams
Reconciliation that closes.
List settlements by date range, match every payout to its deposit and your customer reference, and book the itemised fee without a spreadsheet.
GET /v1/settlements?from=…&to=…fee_ngnon every object- Idempotent requests, no duplicate wallets
Only need the rate? That part is free, for everyone.
The same live feed that powers every rate page on monica.cash is open to anyone: seven coins, the naira rate Monica pays, the deposit fee and seven days of history in one JSON document. No key, no sign up, no invoice. Read it from a server, a script, a spreadsheet tool or straight from the browser.
It is the number to show your users before they send. The binding rate on a conversion is still the one the off ramp API locks at confirmation.
Live now · naira per coin from the feed
- BTC Bitcoin ₦110,031,550
- ETH Ethereum ₦3,176,846
- USDT Tether ₦1,370
- USDC USD Coin ₦1,370
- SOL Solana ₦137,456
- BNB BNB ₦1,007,397
- TRX Tron ₦449.01
Rendered from /live/rates as the page loads, the way your app would.
GET monica.cash/live/rates JSON every 20 seconds no key
Three steps from sandbox to settlement.
Build in the sandbox.
Everything works identically at the sandbox base URL with your test key and testnet coins, so you can integrate before any review.
sk_test_…sandbox.api.monica.cash/v1Pass a short KYB review.
Send your company name, RC number, website, expected monthly volume and the corporate bank account that should receive settlements. Most reviews complete within two business days.
Switch to live keys.
You receive a production key and a webhook signing secret for each environment. Register your HTTPS endpoint and settlements start landing.
sk_live_…whsec_…
Start in the sandbox today.
Read the full reference, then write to us for keys. API access is issued to registered businesses after the KYB review.
Monica is an off ramp. Deposit addresses are settlement endpoints, not custodial wallets: on confirmation the crypto passes to Monica's treasury and you are paid naira.
700,000+ users on Monica ₦1T+ processed 60s settlement after confirmation

