Common scenarios
- Locking in value after a deposit: A user deposits BTC. You immediately swap it to USDT to avoid exposure to BTC price movements while the funds are held.
- Timing a payout: You hold USDT and want to convert to NGN right before settling a payout, minimising the time your funds sit in a volatile position.
- Rebalancing treasury: You hold a mix of assets and want to rebalance into stablecoins at the end of each day.
How it works
Get a quote
Call the Create quote endpoint with your source currency, target currency, amount, and side (BUY or SELL). The response includes the current rate and the exact amount you’ll receive, along with a validity window in seconds.
Review and accept
If the rate is acceptable, accept the quote within the validity window using the returned
quoteId. Obiex executes the swap instantly at the quoted rate.There are no extra charges for trading. Obiex does not add fees on top of the quoted rate.
Supported pairs
Use the/trades/pairs endpoint to see all available trading pairs. Common pairs include:
- BTC / USDT
- ETH / USDT
- BNB / USDT
- USDT / NGNX
Key endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /trades/pairs | List all supported trading pairs |
| GET | /trades/pairs/{sourceCode}/{targetCode} | Get rate info for a specific pair |
| POST | /trades/quote | Request a swap quote |
| POST | /trades/quote/{quoteId} | Accept a quote and execute the swap |
| GET | /wallets/{currencyCode} | Verify updated balance after a swap |
| GET | /trades/summary/me | Review swap history |