2025-07-02

Before

Parameter	Type	Required	Description
after	String	No	Pagination of data to return records earlier than the requested `ts`, Unix timestamp format in milliseconds, e.g. `1597026383085`
before	String	No	Pagination of data to return records newer than the requested `ts`, Unix timestamp format in milliseconds, e.g. `1597026383085`

After

Parameter	Type	Required	Description
after	String	No	Pagination of data to return records earlier than the requested `ts` or `billId`, Unix timestamp format in milliseconds, e.g. `1597026383085`
before	String	No	Pagination of data to return records newer than the requested `ts` or `billId`, Unix timestamp format in milliseconds, e.g. `1597026383085`
pagingType	String	No	PagingType `1`: Timestamp of the bill record `2`: Bill ID of the bill record The default is `1`

Parameter	Type	Description
notes	String	Notes

2025-04-17

Error code	Error Message
59515	You are currently not on the custody whitelist. Please contact customer service for assistance.
59516	Please create the Copper custody funding account first.
59517	Please create the Komainu custody funding account first.
59518	You can’t create a sub-account using the API; please use the app or web.
59519	You can’t use this function/feature while it's frozen, due to: {freezereason}

Due to compliance requirements, Bahamas entity users need to pass in the field rcvrInfo when making withdrawal.

If users withdraw assets to the exchange wallet, they need to provide exchange info & recipient information.

Users can query supported exchanges through the endpoint of Get exchange list (public)
Users need to pass in the following field information of the recipient (rcvrFirstName, rcvrLastName, rcvrCountry, rcvrCountrySubDivision, rcvrTownName, rcvrStreetName). For the exchange wallet belongs to business recipient, rcvrFirstName may input the company name, rcvrLastName may input "N/A", location info may input the registered address of the company. The examples are as follows:

If users withdraw assets to the private wallet, they need to provide recipient information.

Users need to pass in the following field information of the recipient (rcvrFirstName, rcvrLastName, rcvrCountry, rcvrCountrySubDivision, rcvrTownName, rcvrStreetName). For the exchange wallet belongs to business recipient, rcvrFirstName may input the company name, rcvrLastName may input "N/A", location info may input the registered address of the company. The examples are as follows:

Parameter	Type	Description
notionalUsdForBorrow	String	Notional value for `Borrow` in USD Applicable to `Spot mode`/`Multi-currency margin`/`Portfolio margin`
notionalUsdForSwap	String	Notional value of positions for `Perpetual Futures` in USD Applicable to `Multi-currency margin`/`Portfolio margin`
notionalUsdForFutures	String	Notional value of positions for `Expiry Futures` in USD Applicable to `Multi-currency margin`/`Portfolio margin`
notionalUsdForOption	String	Notional value of positions for `Option` in USD Applicable to `Spot mode`/`Multi-currency margin`/`Portfolio margin`

Before

Parameter	Type	Description
minFee	String	The minimum withdrawal fee for normal address Apply to `on-chain withdrawal`
maxFee	String	The maximum withdrawal fee for normal address Apply to `on-chain withdrawal`
minFeeForCtAddr	String	The minimum withdrawal fee for contract address Apply to `on-chain withdrawal`
maxFeeForCtAddr	String	The maximum withdrawal fee for contract address Apply to `on-chain withdrawal`

After

Parameter	Type	Description
fee	String	The fixed withdrawal fee Apply to `on-chain withdrawal`
minFee	String	The minimum withdrawal fee for normal address Apply to `on-chain withdrawal` (Deprecated)
maxFee	String	The maximum withdrawal fee for normal address Apply to `on-chain withdrawal` (Deprecated)
minFeeForCtAddr	String	The minimum withdrawal fee for contract address Apply to `on-chain withdrawal` (Deprecated)
maxFeeForCtAddr	String	The maximum withdrawal fee for contract address Apply to `on-chain withdrawal` (Deprecated)

Parameter	Type	Description
burningFeeRate	String	Burning fee rate, e.g "0.05" represents "5%". Some currencies may charge combustion fees. The burning fee is deducted based on the withdrawal quantity (excluding gas fee) multiplied by the burning fee rate. Apply to `on-chain withdrawal`

Parameter	Type	Description
burningFeeRate	String	Burning fee rate, e.g "0.05" represents "5%". Some currencies may charge combustion fees. The burning fee is deducted based on the withdrawal quantity (excluding gas fee) multiplied by the burning fee rate.
feeCcy	String	Fixed withdrawal fee unit

Nitro spread supports market orders, the request and response parameter ordType adds the enumeration value market.
Nitro spread adds a new order cancellation scenario, the cancelSource response parameter adds the enumeration value 15: Order canceled: The order price is beyond the limit.

Added call auction details WebSocket channel
- WS / Call auction details channel

Parameter	Type	Description
enableSpotBorrow	Boolean	Whether borrow is allowed or not in `Spot mode` `true`: Enabled `false`: Disabled
spotBorrowAutoRepay	Boolean	Whether auto-repay is allowed or not in `Spot mode` `true`: Enabled `false`: Disabled

Parameter	Type	Description
ccy	String	Currency

Parameter	Type	Description
isTradeBorrowMode	String	Whether borrowing currency automatically true false Only applicable to `trigger order`, `trailing order` and `twap order`