ChangeNOW — Cross-Chain Swaps
Provider-abstracted swap routes backed by ChangeNOW for currency discovery, rate estimates, minimums, address validation, swap creation, and status tracking. API key injected server-side — no client-side keys needed.
Upstream: api.changenow.io/v2Auth: Server-side API keyAliases: /api/swap/changenow, /api/onimbus/swap, /changenow
Currency Discovery
| Method | Endpoint | Query | Description |
|---|---|---|---|
| GET | /api/swap/changenow/currencies | active, flow, buy, sell | List all exchangeable currencies |
| GET | /api/changenow/currencies | active, flow, buy, sell | Alias |
| GET | /api/onimbus/swap/currencies | active, flow, buy, sell | Alias |
Range & Pair Info
| Method | Endpoint | Query | Description |
|---|---|---|---|
| GET | /api/swap/changenow/range | fromCurrency, toCurrency, networks | Exchange range with network support |
| GET | /api/changenow/range | fromCurrency, toCurrency, networks | Alias |
| GET | /api/onimbus/swap/range | fromCurrency, toCurrency, networks | Alias |
Create Swap
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/swap/changenow/create | Create swap (full ChangeNOW payload) |
| POST | /api/changenow/create | Alias |
| POST | /api/onimbus/swap/create | Alias |
| POST | /api/swap/change | Shortcut alias |
Wildcard Passthrough
Any path under these prefixes is forwarded verbatim with API key header injected.
| Method | Prefix |
|---|---|
| ALL | /changenow/* |
| ALL | /api/changenow/* |
| ALL | /api/onimbus/swap/* |
Quick examples
# List available currencies
curl -s https://api.onimbus.cloud/api/swap/changenow/currencies
# Check a pair's range (BTC → ETH)
curl -s 'https://api.onimbus.cloud/api/swap/changenow/range?fromCurrency=btc&toCurrency=eth'
# Create a swap
curl -s -X POST https://api.onimbus.cloud/api/swap/changenow/create \
-H 'content-type: application/json' \
-d '{"fromCurrency":"btc","toCurrency":"eth","fromAmount":"0.01","toAddress":"0x..."}'