Hotcoin — Spot & Perpetual Futures
Centralized exchange endpoints proxied through api.onimbus.cloud. Public data is keyless; signed endpoints require a Nimbus API key injected server-side. Subaccounts are virtual constructs layered over the master account with ownership, allowlists, notional limits, and dry-run order safety gates.
Spot: api.hotcoinfin.com
Perps: api-ct.hotcoin.fit
Auth: HMAC-SHA256 v2
Subaccounts: Virtual (perps only)
Spot — Public (no auth)
| Method | Endpoint | Description |
|---|
| GET | /api/hotcoin/common/symbols | All spot trading pairs |
| GET | /api/hotcoin/market/ticker | 24h ticker (all pairs) |
| GET | /api/hotcoin/ticker | Single/multi ticker |
| GET | /api/hotcoin/depth | Order book depth |
| GET | /api/hotcoin/trade | Recent trades |
Spot — Signed (HMAC required)
All other /api/hotcoin/* paths: account, orders, wallet, etc.
| Method | Endpoint | Description |
|---|
| GET | /api/hotcoin/balance | Spot balances |
| GET | /api/hotcoin/entrust | Current orders |
| GET | /api/hotcoin/entrusts | Order history |
| GET | /api/hotcoin/trade/list | Trade history |
| POST | /api/hotcoin/order/place | Place spot order |
| POST | /api/hotcoin/order/cancel | Cancel order |
| GET | /api/hotcoin/finance/* | Deposit, withdraw, transfer |
Perps — Public
| Method | Endpoint | Description |
|---|
| GET | /api/hotcoin-perp/public/products | All perpetual contracts |
| GET | /api/hotcoin-perp/public/depth | Perp order book |
| GET | /api/hotcoin-perp/public/trades | Perp recent trades |
| GET | /api/hotcoin-perp/public/ticker | Perp 24h ticker |
| GET | /api/hotcoin-perp/public/index | Index price |
Perps — Signed
| Method | Endpoint | Description |
|---|
| GET | /api/hotcoin-perp/account/assets | Perp balance |
| GET | /api/hotcoin-perp/position/list-all | Open positions |
| GET | /api/hotcoin-perp/products/{code}/list | Orders per contract |
| POST | /api/hotcoin-perp/products/{code}/order | Place perp order |
| DEL | /api/hotcoin-perp/products/{code}/order/{id} | Cancel perp order |
Master Account (Nimbus-managed)
| Method | Endpoint | Description |
|---|
| GET | /api/nimbus/hotcoin-perp/master/status | Health: keys, trading enabled, allowed contracts |
| GET | /api/nimbus/hotcoin-perp/master/assets | Master balance/assets |
| GET | /api/nimbus/hotcoin-perp/master/positions | Open positions (env: 0=live, 1=demo) |
| GET | /api/nimbus/hotcoin-perp/master/orders/{contractCode} | Orders per contract (allowlist-enforced) |
| POST | /api/nimbus/hotcoin-perp/master/orders | Submit order. Supports dryRun + confirmLiveOrder |
| DEL | /api/nimbus/hotcoin-perp/master/orders/{contractCode}/{id} | Cancel order (requires confirmLiveOrder) |
Subaccounts (Virtual, perps only)
Owner types: user, agent, strategy, treasury, portfolio. Enforced limits: maxNotionalUsd, maxOpenOrders, maxLeverage.
| Method | Endpoint | Description |
|---|
| GET | /api/nimbus/hotcoin-perp/subaccounts | List subaccounts with resolved limits |
| POST | /api/nimbus/hotcoin-perp/subaccounts | Create subaccount (ownerId, limits, env, allocation) |
| GET | /api/nimbus/hotcoin-perp/subaccounts/{id}/status | Subaccount health: positions + bound orders |
| POST | /api/nimbus/hotcoin-perp/subaccounts/{id}/orders | Submit order attributed to subaccount |
| DEL | /api/nimbus/hotcoin-perp/subaccounts/{id}/orders/{contractCode}/{orderId} | Cancel bound order (ownership check) |
Curated Spot Pairs
| Method | Endpoint | Description |
|---|
| GET | /api/hotcoin/pairs/curated | Curated pairs by category (top-pairs, spot-group-2), enriched with live ticker |
Nimbus Swap Provider
Use provider=hotcoin on unified swap routes.
| Method | Endpoint | Description |
|---|
| POST | /api/private/quote (provider=hotcoin) | Spot swap quote |
| POST | /api/private/order (provider=hotcoin) | Execute spot order |
| GET | /api/private/order/{id} | Order status |
| POST | /api/private/stagger (provider=hotcoin) | Batch quotes + orders |
Quick examples
# Spot — List all trading pairs
curl -s https://api.onimbus.cloud/api/hotcoin/common/symbols
# Spot — Get ticker for BTC/USDT
curl -s 'https://api.onimbus.cloud/api/hotcoin/ticker?symbol=btc_usdt'
# Perps — List all perpetual contracts
curl -s 'https://api.onimbus.cloud/api/hotcoin-perp/public/products'
# Master — Check master account status
curl -s https://api.onimbus.cloud/api/nimbus/hotcoin-perp/master/status
# Subaccounts — Create subaccount (Bearer + HotcoinSecret required)
curl -s -X POST https://api.onimbus.cloud/api/nimbus/hotcoin-perp/subaccounts \
-H 'content-type: application/json' \
-H 'authorization: Bearer YOUR_TOKEN' \
-d '{"ownerId":"user123","ownerType":"agent","environment":"demo","allowedContracts":["BTC-USDT"],"maxNotionalUsd":"10000","maxLeverage":"10"}'
# Subaccount — Submit order (dry run first)
curl -s -X POST https://api.onimbus.cloud/api/nimbus/hotcoin-perp/subaccounts/{id}/orders \
-H 'content-type: application/json' \
-H 'authorization: Bearer YOUR_TOKEN' \
-d '{"dryRun":true,"contractCode":"BTC-USDT","order":{"side":"buy","type":"limit","price":"87000","qty":"0.01"}}'