Skip to main content

Changelog

Notable additions and changes to the CoinSwitch API trading surfaces. Most recent first.

28 Aug 2025​

Updated the Python sample for both balance updates and order updates private user streams to match the current Socket.IO v4 client conventions.

24 Jul 2025​

Options trading via API is now live for a select group of users. To request access, email api@coinswitch.co.

13 Dec 2024​

Added the Balance Updates private user stream — a Socket.IO subscription that pushes a fresh wallet snapshot whenever any balance changes (placements, fills, cancellations). See Spot › Balance Updates.

25 Jul 2024​

Updated Trading Fee response to include the discount field and the post-discount fee, so applications can show users their effective fee without a separate lookup.

23 Jul 2024​

New endpoints:

  • GET /trade/api/v2/tradingFee — see Trading Fee. Returns the fee applicable to your account on a given exchange.

2 Jul 2024​

Security upgrade — X-AUTH-EPOCH header. The signature scheme now signs an epoch (Unix ms) timestamp into the message, and the same epoch is sent in a header. This addresses replay and precision-matching concerns with the older scheme.

The legacy scheme (no epoch) was supported in parallel and announced for phase-out on 15 Aug 2024. All current docs and examples assume the epoch scheme.

New endpoints:

  • GET /trade/api/v2/tradeInfo — see Trade Info. One call returns precision, min/max, and active status for all coins on the platform.
  • GET /trade/api/v2/tds — see TDS. Returns accumulated TDS for your orders. (TDS from C2C orders arrives with a 1-day delay.)
  • GET /trade/api/v2/time — server time, useful for clock-skew checks before signing.

24 May 2024​

Added the Order Updates private user stream — a Socket.IO subscription that pushes a message every time an order's status changes. Use this in place of polling Get Order. See Spot › Order Updates.

9 Feb 2024​

  • Added a new exchange identifier c2c2 for additional USDT pairs. See Exchange Identifiers.
  • Changed the WebSocket handshake path from /pro/realtime-rates-socket to /pro/realtime-rates-socket/spot/{parameter}. The change was backward-compatible until 1 Apr 2024, when the older path was removed.

16 Jan 2024​

Updated the Java signature-generation sample for better precision handling. The older sample continues to work.

26 Dec 2023​

Updated request limits for Create Order, Portfolio, List Orders (open and closed). Current limits are documented in Errors & Rate Limits.

10 Nov 2023​

Added the Candlestick WebSocket — pushes 1-minute candles in real time. See Spot › Candlestick.

Optimized Closed Orders:

  • Default count raised to 500 — fewer round-trips for typical history lookups.
  • Removed total_orders_count from the response of both Open Orders and Closed Orders to reduce response size.

6 Nov 2023​

Removed blocked_balance_deposit, blocked_balance_withdraw, blocked_balance_stake, and blocked_balance_vault from the Portfolio response.

25 Sep 2023​

Two new intermediate order statuses:

  • CANCELLATION_RAISED — we've asked the exchange to cancel the order, but the exchange hasn't confirmed yet. Resolves to CANCELLED.
  • EXPIRATION_RAISED — the order is in the process of expiring. While in this state, cancellation is not allowed.

See Order Lifecycle for the full state machine.

New endpoints:

Other changes:

  • All endpoints now return C2C USDT pairs with the same response contract as INR pairs.
  • Removed the legacy S, a, b parameters from the Trade API and trade socket response.
  • Removed baseAsset and quoteAsset from the Ticker API and ticker socket response.

4 Aug 2023​

v2 API improvements with stronger security and more consistent response shapes across endpoints.

New v2 endpoints:

  • GET /trade/api/v2/validate/keys — validate keys
  • GET /trade/api/v2/ping — health check
  • POST /trade/api/v2/order — Create Order
  • DELETE /trade/api/v2/order — Cancel Order
  • GET /trade/api/v2/orders — List Orders (open and closed via open=true|false)
  • GET /trade/api/v2/user/portfolio — Portfolio
  • POST /trade/api/v2/exchangePrecision — Exchange Precision
  • GET /trade/api/v2/24hr/all-pairs/ticker — Tickers (all pairs)
  • GET /trade/api/v2/24hr/ticker — Tickers (single pair)
  • GET /trade/api/v2/depth — Depth
  • GET /trade/api/v2/trades — Trades
Last updated on