Get started
Overview
Wallets, naira collections, swaps and payouts for your customers, from your server, with one API key. Rimoswap holds the money and runs the rails; you build the product.
What you can build
An exchange, a wallet, a savings or remittance app: anything where your customers hold, move or convert crypto and naira. The API gives you the parts.
Customer addressesA crypto deposit address for each of your customersNaira collectionsBank details for a customer to pay naira inSwapsCrypto to crypto, crypto to naira, at a quoted rateCrypto payoutsSend to any wallet from your balanceNaira bank payoutsPay any Nigerian bank account, name-checkedLedgerEvery movement, signed, to reconcile against
How it fits together
- One balance, yours. Every deposit and collection from your customers is credited to your Rimoswap balance, tagged with your
customer_id. Swaps and payouts spend from that same balance. - Your customers stay yours. You keep each customer's balance in your own ledger and you know your customers (KYC). We never see their names, except a payer's identity on a naira collection, which goes to our bank partner and is not stored.
- Everything is told to you. Each change arrives at your webhook, signed. The ledger lists every movement to reconcile against.
- Build first, approve later. Test keys work at once against a funded sandbox. Live money moves only after business verification and approval, product by product.
At a glance
| Product | Money | You call | You hear |
|---|---|---|---|
| Customer addresses | Crypto in | POST /v1/customers/addresses | deposit:confirmed |
| Naira collections | Naira in, credited as USDT | POST /v1/collections | collection:completed |
| Swaps | Converts your balance | POST /v1/swaps/quote, /v1/swaps | swap:completed |
| Crypto payouts | Crypto out | POST /v1/payouts | payout:completed / failed |
| Naira bank payouts | Naira out | POST /v1/bank-payouts | bank_payout:completed / failed |
Start here
The quickstart takes five minutes in the sandbox. Base URL: http://localhost:4188/api
Your first callcURL
curl http://localhost:4188/api/v1/account \ --header "X-Api-Key: rmo_test_..."