Skip to main content

Categories

HFT endpoints accept a category parameter that determines which product line the call applies to.

CategoryProductNotes
linearUSDT-margined perpetual futuresDefault for HFT accounts. All examples in these docs use linear.
optionOptionsContact 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

ConceptFormatExamples
CoinAsset codeUSDT, 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).