Change settlement currency

POST🔒 Trading

tip

Try It Out — test this endpoint in the API Explorer

Switches the collateral (settlement) currency of the caller's position on the given symbol.

Name	Type	Required	Description
symbol	String	Yes	Trading symbol whose position collateral currency should be switched (e.g., BTC-PERP).
currency	String	Yes	Target settlement currency to hold the position's collateral in (e.g., USDT).
positionId	String	No	Existing position identifier to switch. Optional; when omitted the symbol's default position is used.

Name	Type	Description
symbol	String	Trading symbol whose position collateral currency was switched.
timestamp	Long	Server processing time, Unix timestamp in milliseconds.
status	Integer	Result status code (0 indicates success; non-zero indicates failure).
type	Integer	Result type code returned by the trading system.

example

POSThttps://api.btse.com/futures/api/v3/trade/settle_in

Request (default)

{
  "symbol": "BTC-PERP",
  "positionId": "BTC-PERP-USDT",
  "currency": "USD"
}

Response (default)

{
  "symbol": "BTC-PERP",
  "timestamp": 1784882345085,
  "status": 20,
  "type": 96
}