Crypto Com Cdcx Market Intel

---
name: cdcx-market-intel
description: Fetch and analyze market data — prices, orderbook depth, candles, recent trades
---

# Market Intelligence

## When to Use

- User asks for current price, price history, or market conditions for a crypto instrument
- Need to assess liquidity (orderbook depth) before placing an order
- Building a market summary or watchlist
- Comparing prices across multiple instruments

## Tools Used

| Tool                           | Purpose                                   |
|--------------------------------|-------------------------------------------|
| cdcx_market_ticker             | Current price for one or all instruments  |
| cdcx_market_book               | Orderbook depth                           |
| cdcx_market_candlestick        | Historical OHLCV bars                     |
| cdcx_market_trades             | Recent public trades                      |
| cdcx_market_instruments        | All tradable instruments and metadata     |
| cdcx_market_valuations         | Mark / index / funding values             |
| cdcx_market_settlement_prices  | Settlement prices for expired contracts   |
| cdcx_market_insurance          | Insurance Fund balance by currency        |
| cdcx_market_risk_params        | Smart Cross Margin risk parameters        |

All tools are read-only (no auth required, no acknowledgement needed).

## Workflow

### Single Instrument Price

```
cdcx market ticker BTC_USDT -o json
```

Returns: `last`, `b` (best bid), `k` (best ask), `h`/`l` (24h high/low), `v` (volume), `c` (24h change ratio — multiply by 100 for percent).

### All Tickers (Market Scan)

```
cdcx market ticker -o json
```

Omit the instrument argument to get every tradable instrument in one call. Ideal for market scans, watchlists, or computing leaders/laggards.

### Orderbook Depth

```
cdcx market book BTC_USDT --depth 10 -o json
```

`--depth` caps at 50. Use for liquidity assessment before sizing a trade: sum top-N asks for a worst-case buy-through price.

### Candlestick History

```
cdcx market candlestick BTC_USDT --timeframe 1h --count 24 -o json
```

Supported timeframes: `1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1D, 7D, 14D, 1M`. Use `--start-ts` / `--end-ts` (Unix seconds) for explicit windows. Default window is 1 day.

### Recent Trades

```
cdcx market trades BTC_USDT -o json
```

Last prints, up to 7 days back. Useful for spotting large prints or sudden activity.

### Instrument Metadata

```
cdcx market instruments -o json
```

Returns every instrument with: `instrument_name`, `base_ccy`, `quote_ccy`, `quantity_tick_size`, `price_tick_size`, `min_quantity`, `max_quantity`, `tradable`. Essential before placing any order — the price/quantity you submit must conform to these tick sizes.

### Composite Market Snapshot

```
cdcx market ticker BTC_USDT          # current price
cdcx market book BTC_USDT --depth 5  # liquidity snapshot
cdcx market candlestick BTC_USDT --timeframe 1D --count 7  # weekly trend
cdcx market trades BTC_USDT          # recent activity
```

Combine into a one-shot briefing for the user.

### Derivatives-Only

```
cdcx market valuations BTC-PERP --valuation-type mark_price -o json
cdcx market settlement-prices BTC-PERP -o json
cdcx market insurance USDT -o json
cdcx market risk-params -o json
```

Only relevant for perpetual/futures instruments.

## Streaming

For continuous updates prefer `cdcx stream` over polling:

```
cdcx stream ticker BTC_USDT ETH_USDT  # NDJSON to stdout
cdcx stream book BTC_USDT
cdcx stream trades BTC_USDT
```

Stream commands print one JSON object per line. Ctrl+C to stop.

## Notes

- Prices in the API are strings — cast to float/decimal before arithmetic
- `c` in ticker is a ratio, not a percentage: `0.0257` means +2.57%
- Instrument names: spot uses `_USDT` (e.g. `BTC_USDT`), perps use `-PERP` (e.g. `BTC-PERP`)
- All market data endpoints are public — no credentials needed