Categories
HFT endpoints accept a category parameter that determines which product line the call applies to.
| Category | Product | Notes |
|---|---|---|
linear | USDT-margined perpetual futures | Default for HFT accounts. All examples in these docs use linear. |
option | Options | Contact your account manager to enable. |
category is a required parameter on most market-data, order, position, and execution endpoints. Pass it as a query parameter on GET calls and as a JSON body field on POST calls.
Example
curl 'https://dma.coinswitch.co/v5/market/tickers?category=linear&symbol=BTCUSDT'
curl -X POST 'https://dma.coinswitch.co/v5/order/create' \
-H 'Content-Type: application/json' \
-d '{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Buy",
"orderType": "Market",
"qty": "0.001"
}'
If you omit category on an endpoint that requires it, you'll get a retCode: 10001 response with retMsg indicating the missing parameter.
Coin and symbol conventions
| Concept | Format | Examples |
|---|---|---|
| Coin | Asset code | USDT, BTC, ETH |
| Symbol | {base}{quote} (no separator) | BTCUSDT, ETHUSDT, DOGEUSDT |
This differs from Spot v2 (which uses BTC/INR) and matches Futures v2 (which also uses BTCUSDT).