SplitNOW — Split-Swap Aggregator
Multi-provider split-swap aggregator with unified quote/order routing across SplitNOW, Hotcoin, and OKX DEX. Provider auto-detected from body/query/header. Supports staggered multi-leg execution.
Upstream: splitnow.io/api3-provider routing: SplitNOW + Hotcoin + OKXAuth: Server-side API keyAliases: /api/private, /api/splitnow, /splitnow
Unified Quote & Order (Provider-Aware)
| Method | Endpoint | Description |
|---|
| GET | /api/swap/split/quote | Create quote (auto-detect provider: splitnow, hotcoin, okx) |
| POST | /api/swap/split/quote | Create quote with body. provider param selects provider. |
| POST | /api/swap/split/order | Execute order (auto-detect provider) |
| GET | /api/swap/split/order/:id | Order status lookup |
| POST | /api/swap/split | Multiplex: auto-detect quote vs order |
SplitNOW Direct
| Method | Endpoint | Upstream | Description |
|---|
| GET | /api/private/assets/ | GET /api/assets/ | Supported assets |
| GET | /api/private/assets/prices/ | GET /api/assets/prices/ | Asset prices |
| GET | /api/private/assets/limits/ | GET /api/assets/limits/ | Asset limits |
| GET | /api/private/assets/catalog/ | Merged | Assets + limits merged |
| GET | /api/private/exchangers/ | GET /api/exchangers/ | Exchange list |
Staggered Execution
| Method | Endpoint | Description |
|---|
| POST | /api/swap/split/stagger | Multi-leg staggered swap execution. Body: mode, legs[], quoteTemplate, orderTemplate. Supports provider=hotcoin override. |
Wildcard Passthrough
| Method | Prefix |
|---|
| ALL | /splitnow/* |
| ALL | /api/splitnow/* |
| ALL | /api/private/* |
Quick examples
# Get SplitNOW asset catalog
curl -s https://api.onimbus.cloud/api/private/assets/catalog/
# Create a split-swap quote (SplitNOW)
curl -s -X POST https://api.onimbus.cloud/api/swap/split/quote \
-H 'content-type: application/json' \
-d '{"provider":"splitnow","quoteInput":{"from":"BTC","to":"ETH"},"quoteOutputs":[{"amount":"0.01"}]}'
# Create a quote via OKX DEX provider
curl -s -X POST https://api.onimbus.cloud/api/swap/split/quote \
-H 'content-type: application/json' \
-d '{"provider":"okx","chainId":"8453","fromTokenAddress":"0x...","toTokenAddress":"0x...","amount":"1000000"}'
# Execute a staggered multi-leg swap
curl -s -X POST https://api.onimbus.cloud/api/swap/split/stagger \
-H 'content-type: application/json' \
-d '{"mode":"sequential","legs":[{"from":"BTC","to":"USDT","amount":"0.01"},{"from":"USDT","to":"ETH","amount":"auto"}],"quoteTemplate":{},"orderTemplate":{}}'