Build anything on Cube Exchange.

Every market-data endpoint is public. Fetch the markets, then a book and candles:

# 1. all markets
curl https://commodities.gocube.org/api/v2/commodity/v1/markets

# 2. order book + candles
curl "https://commodities.gocube.org/api/v2/commodity/v1/orderbook?symbol=USDT/NGN"
curl "https://commodities.gocube.org/api/v2/commodity/v1/ohlcv?symbol=USDT/NGN&timeframe=1h&limit=100"

To trade, generate an API key and send it as X-API-Key. That’s the whole model — no request signing, no nonces.

Market data is public — no key required. Trading requires an API key issued to your Cube Exchange (Cubemail) account. Send it on every trading request:

X-API-Key: cdx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Manage keys from your account or the generator below. Programmatic key management is also available with an existing session:

Limits are generous and designed for real-time bots and minutely aggregator polling.

[
  { "id": "usdtngn", "symbol": "USDT/NGN", "base": "USDT", "quote": "NGN",
    "active": true, "type": "spot", "spot": true,
    "taker": 0.0015, "maker": 0.0015,
    "precision": { "amount": 8, "price": 8 },
    "limits": { "amount": { "min": "1" } } }
]

{
  "symbol": "USDT/NGN",
  "bids": [ ["1372.10", "42.5"], ["1372.05", "18.0"] ],
  "asks": [ ["1372.40", "31.2"], ["1372.55", "12.8"] ],
  "timestamp": 1720008000000, "datetime": "2026-07-03T12:00:00.000Z"
}

[
  [ 1720008000000, "1372.1", "1372.4", "1371.6", "1372.9", "142.5" ]
]  // [ time_ms, open, high, low, close, volume ]

A public, keyless market-data feed in the industry-standard exchange format consumed by data vendors, aggregators and market terminals — pair-level tickers, full depth and the historical tape. Pair ids here are uppercase BASE_TARGET (e.g. USDT_NGN), and all values are decimal strings.

[
  { "ticker_id": "USDT_NGN", "base_currency": "USDT", "target_currency": "NGN",
    "last_price": "1372.19", "base_volume": "1.04", "target_volume": "1439.83",
    "bid": "1370.0", "ask": "1374.0", "high": "1398.5", "low": "1360.4" }
]

{ "ticker_id": "USDT_NGN", "timestamp": 1720008000000,
  "bids": [ ["1370.0", "42.5"] ], "asks": [ ["1374.0", "31.2"] ] }

{ "buy":  [ { "trade_id": 961247, "price": "1372.19", "base_volume": "0.0001",
      "target_volume": "0.134", "trade_timestamp": 1720008000000, "type": "buy" } ],
  "sell": [ … ] }

Stream the market in realtime over a single connection instead of polling. One socket carries three channels per symbol — the live trade tape, ticker updates and order-book snapshots — pushed as JSON text frames. No key required; the feed is public and read-only.

Subscribe by sending a JSON frame naming the channels you want as channel:SYMBOL (unified BASE/QUOTE). The server acknowledges, then streams matching frames. Send ping to keep the link warm.

Channels

Client → server

{ "method": "subscribe",   "params": ["trades:USDT/NGN", "ticker:USDT/NGN", "book:USDT/NGN"] }
{ "method": "unsubscribe", "params": ["book:USDT/NGN"] }
{ "method": "ping" }

Server → client

{ "event": "welcome", "channels": ["trades","ticker","book"] }
{ "event": "subscribed", "channels": ["trades:USDT/NGN", …] }
{ "channel": "trades", "symbol": "USDT/NGN", "data": [ { "id": "961247", "price": "1372.19", "amount": "0.0001", "side": "buy", "timestamp": 1720008000000 } ] }
{ "channel": "ticker", "symbol": "USDT/NGN", "data": { "last": "1372.19", "bid": "1370.0", "ask": "1374.0", "high": "1398.5", "low": "1360.4", "baseVolume": "1.04" } }
{ "channel": "book",   "symbol": "USDT/NGN", "data": { "bids": [["1370.0","42.5"]], "asks": [["1374.0","31.2"]], "timestamp": 1720008000000 } }
{ "event": "pong" }

Connect

# quick test from a terminal
wscat -c "wss://commodities.gocube.org/api/v2/commodity/v1/ws"
> {"method":"subscribe","params":["trades:USDT/NGN","ticker:USDT/NGN","book:USDT/NGN"]}

The socket also answers at /ws and /feed/ws under the same host. Trades stream only new prints from the moment you subscribe — seed history from /v1/trades. Reconnect and re-subscribe on disconnect; snapshots make the book self-healing.

Build a charting datafeed from /v1/ohlcv: request candles by symbol and timeframe, and page through history with since (unix ms) and limit. Supported timeframes are 1m · 5m · 15m · 1h · 4h · 1d. Each row is [ time_ms, open, high, low, close, volume ], oldest first — ready to map onto any candlestick widget. Pair time-series with /v1/trades for the live tape and /v1/ticker for the header stats.

# last 500 hourly candles for USDT/NGN
curl "https://commodities.gocube.org/api/v2/commodity/v1/ohlcv?symbol=USDT/NGN&timeframe=1h&limit=500"

# a historical window (since = unix ms)
curl "https://commodities.gocube.org/api/v2/commodity/v1/ohlcv?symbol=USDT/NGN&timeframe=1d&since=1717200000000&limit=90"

{
  "USDT": { "free": "1200.00", "used": "300.00", "total": "1500.00" },
  "NGN":  { "free": "540000",  "used": "0",      "total": "540000" },
  "free": { "USDT": "1200.00", "NGN": "540000" }, "used": { … }, "total": { … }
}

curl -X POST https://commodities.gocube.org/api/v2/commodity/v1/order \
  -H "X-API-Key: $KEY" -H "content-type: application/json" \
  -d '{"symbol":"USDT/NGN","type":"limit","side":"buy","amount":"100","price":"1370"}'

{ "id": "5231", "symbol": "USDT/NGN", "type": "limit", "side": "buy",
  "price": "1370", "amount": "100", "filled": "0", "remaining": "100",
  "status": "open", "timeInForce": "GTC", "timestamp": 1720008000000 }

Every resource returns one consistent shape. Prices, sizes and amounts are decimal strings; timestamps are unix milliseconds paired with an ISO-8601 datetime; every structure carries a raw info object with the underlying exchange payload.

Market

Ticker

Order book

{ symbol, bids: [[price, amount], …], asks: [[price, amount], …], timestamp, datetime } — bids sorted high→low, asks low→high.

OHLCV

An array of arrays, oldest first: [ timestamp_ms, open, high, low, close, volume ].

Trade

Order

Balance

A map of { CODE: { free, used, total } } plus flat free, used and total maps. free is available, used is locked in open orders, total = free + used.

Currency

{ id, code, name, active, deposit, withdraw, precision }, keyed by uppercase code.

A minimal two-sided quoter — read the reference price, lay a bid and an ask around it, and cancel-and-replace on a loop so your book is always fresh. Size every quote from your real free balance so you never over-commit.

const B = "https://commodities.gocube.org/api/v2/commodity/v1";
const H = { "content-type": "application/json", "X-API-Key": process.env.API_KEY };
const SYMBOL = "USDT/NGN", SPREAD = 0.002, SIZE = "50";       // 20 bps each side
const j = (u, o) => fetch(B + u, o).then(r => r.json());

async function tick() {
  const t = await j("/ticker?symbol=" + encodeURIComponent(SYMBOL));
  const ref = (parseFloat(t.bid) + parseFloat(t.ask)) / 2 || parseFloat(t.last);
  if (!ref) return;

  const open = await j("/orders/open", { headers: H });        // clear our quotes
  await Promise.all(open.map(o =>
    fetch(`${B}/order/${o.id}/cancel`, { method: "POST", headers: H })));

  const bid = (ref * (1 - SPREAD)).toFixed(2);                 // re-quote both sides
  const ask = (ref * (1 + SPREAD)).toFixed(2);
  for (const [side, price] of [["buy", bid], ["sell", ask]])
    await fetch(B + "/order", { method: "POST", headers: H,
      body: JSON.stringify({ symbol: SYMBOL, type: "limit", side, amount: SIZE, price }) });
  console.log("quoted", bid, "/", ask);
}
setInterval(tick, 5000);

Harden it with multiple ladder levels, inventory skew, and balance-capped sizing — never quote more than your free balance. Use /ohlcv for signals and /balance to track inventory.

Errors return a non-2xx HTTP status with a body of { "error": "message", "status": 4xx }. Each maps to a typed exception so you can catch by kind rather than parse strings.

The API is versioned in the path (/v1). Additive changes ship without a version bump; breaking changes get a new version.