How it works
1
Check which networks accept deposits
Call Get Active Networks and only offer currency/network pairs where
isReceivable is true. Generating an address for a pair where it’s false returns an error.2
Generate a deposit address
Call the deposit address endpoint using the currency code (for example
USDT) and network code (for example TRX), not their display names, plus 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.3
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.
4
Receive the deposit webhook
When the deposit is confirmed on-chain, Obiex sends a webhook to your webhook callback URL with the transaction details.
5
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.