Skip to main content
On-ramping is the process of converting fiat or external crypto into a usable balance on your platform. With Obiex, you can generate unique deposit addresses for your users, accept crypto from any external wallet, and get notified the moment funds arrive. No polling required.

​
How it works

1

Generate a deposit address

Call the deposit address endpoint with a unique identifier for your user. Obiex returns a wallet address tied to that user for a specific currency and network. If you call the endpoint again with the same identifier, the same address is returned.
2

Share the address with your user

Display the deposit address and network to your user so they can send funds from an external wallet or exchange.
3

Receive the deposit webhook

When the deposit is confirmed on-chain, Obiex sends a webhook to your webhook callback URL with the transaction details.
4

Optionally swap to another currency

If your platform operates in a specific currency (e.g. USDT) but a user deposited BTC, use the RFQ trading system to swap the received amount automatically.
Deposit addresses are reusable. The same address will receive multiple deposits over time, so you do not need to generate a new address per transaction.

​
Key endpoints

MethodEndpointDescription
POST/addresses/brokerGenerate a deposit address for a user
GET/addresses/me/brokerList all deposit addresses you have generated
GET/currencies/networks/activeList supported networks and deposit fee information
GET/wallets/{currencyCode}Check your master wallet balance