v3

latestOpenAPI 3.0.02026-07-311784111.3 MB
Trading
Matching Engine
Private

Cancels all open orders for a specific currency. This is useful for quickly clearing all orders across multiple instruments in a currency.

Orders can be optionally filtered by instrument kind (future, option, etc.) and/or order type (limit, market, stop, etc.). Use the detailed parameter to receive a list of all cancelled orders.

Scope: trade:read_write

Try in API console

get/private/cancel_all_by_currency

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' required

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol

kind'future' | 'option' | 'spot' | 'future_combo' | 'option_combo' | 'combo' | 'any'

Instrument kind: "future", "option", "spot", "future_combo", "option_combo", "combo" for any combo or "any" for all

Instrument kind, "combo" for any combo or "any" for all. If not provided instruments of all kinds are considered

type'all' | 'limit' | 'trigger_all' | 'stop' | 'take' | 'trailing_stop'

Order type: "all", "limit", "stop", "take", "trailing_stop", "trailing_take"

Order type - limit, stop, take, trigger_all or all, default - all

detailedboolean

When detailed is set to true, the output format is changed to include a list of all cancelled orders.

📖 Related Article: Detailed Response for Cancel Methods

Default: false

freeze_quotesboolean

Whether or not to reject incoming quotes for 1 second after cancelling (false by default). Related to private/mass_quote request.

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

resultnumber required

Total number of successfully cancelled orders

Example response

{
  "result": 7
}