Advanced Trade: Products
resource: products — market data (PRD01–PRD06)
list (PRD01)
Lists every tradable product. No operation-specific config keys.
Example response:
{
"items": [{
"productID": "BTC-USD",
"baseCurrency": "BTC",
"quoteCurrency": "USD",
"price": "60123.45",
"pricePercentageChange24H": "1.85",
"volume24H": "12345.6789",
"tradingDisabled": false,
"productType": "SPOT"
}]
}
get (PRD02)
Returns a single product record, same shape as list.
| Field | Required | Description |
|---|---|---|
productId | ✓ Yes | The trading pair, e.g. BTC-USD. |
getCandles (PRD03)
Returns OHLC candlestick data.
| Field | Required | Description |
|---|---|---|
productId | ✓ Yes | The trading pair. |
start | No | Defaults to "now" when omitted. A present-but-malformed value is a validation error, not a silent fallback. |
end | No | Same rule as start. |
granularity | No | Candle bucket size. Defaults to ONE_HOUR. |
Output items[], one OHLC candle per bucket: start, low, high, open, close, volume.
getMarketTrades (PRD04)
Returns recent public trades on a product.
| Field | Required | Description |
|---|---|---|
productId | ✓ Yes | The trading pair. |
limit | No | Maximum number of trades to return. |
Output items[]: tradeID, productID, price, size, side, time.
getBestBidAsk (PRD05)
Returns a top-of-book snapshot.
| Field | Required | Description |
|---|---|---|
productIds | No | Comma-separated list of trading pairs. Omit for all products. |
Output items[], one best-bid/ask snapshot per product.
getProductBook (PRD06)
Returns a full order-book snapshot.
| Field | Required | Description |
|---|---|---|
productId | ✓ Yes | The trading pair. |
limit | No | Maximum depth per side. |
Output is a single record: productID, bids[] and asks[] (each {price, size}), time.