Transfer Position

wallet  string required
Public key (wallet) of the account

maker_params  object required
Maker order parameters and signature. Maximum transfer amount is limited by the size of the maker position. Transfers that increase the maker's position size are not allowed.

maker_params. amount  string required
Order amount in units of the base

maker_params. direction  string required
Order direction
enum buy sell

maker_params. instrument_name  string required
Instrument name

maker_params. limit_price  string required
Limit price in quote currency.
This field is still required for market orders because it is a component of the signature. However, market orders will not leave a resting order in the book in case of a partial fill.

maker_params. max_fee  string required
Max fee per unit of volume, denominated in units of the quote currency (usually USDC).Order will be rejected if the supplied max fee is below the estimated fee for this order.

maker_params. nonce  integer required
Unique nonce defined as (UTC_timestamp in ms)(random_number_up_to_3_digits) (e.g. 1695836058725001, where 001 is the random number).Note, using a random number beyond 3 digits will cause JSON serialization to fail.

maker_params. signature  string required
Ethereum signature of the order

maker_params. signature_expiry_sec  integer required
Unix timestamp in seconds. Order signature becomes invalid after this time, and the system will cancel the order.Expiry MUST be at least 5 min from now.

maker_params. signer  string required
Owner wallet address or registered session key that signed order

maker_params. subaccount_id  integer required
Subaccount ID

taker_params  object required
Taker order parameters and signature

taker_params. amount  string required
Order amount in units of the base

taker_params. direction  string required
Order direction
enum buy sell

taker_params. instrument_name  string required
Instrument name

taker_params. limit_price  string required
Limit price in quote currency.
This field is still required for market orders because it is a component of the signature. However, market orders will not leave a resting order in the book in case of a partial fill.

taker_params. max_fee  string required
Max fee per unit of volume, denominated in units of the quote currency (usually USDC).Order will be rejected if the supplied max fee is below the estimated fee for this order.

taker_params. nonce  integer required
Unique nonce defined as (UTC_timestamp in ms)(random_number_up_to_3_digits) (e.g. 1695836058725001, where 001 is the random number).Note, using a random number beyond 3 digits will cause JSON serialization to fail.

taker_params. signature  string required
Ethereum signature of the order

taker_params. signature_expiry_sec  integer required
Unix timestamp in seconds. Order signature becomes invalid after this time, and the system will cancel the order.Expiry MUST be at least 5 min from now.

taker_params. signer  string required
Owner wallet address or registered session key that signed order

taker_params. subaccount_id  integer required
Subaccount ID

id  string or integer required

result  object required

result. maker_order  object required

result.maker_order. amount  string required
Order amount in units of the base

result.maker_order. average_price  string required
Average fill price

result.maker_order. cancel_reason  string required
If cancelled, reason behind order cancellation
enum user_request mmp_trigger insufficient_margin signed_max_fee_too_low cancel_on_disconnect ioc_or_market_partial_fill session_key_deregistered subaccount_withdrawn compliance trigger_failed validation_failed

result.maker_order. creation_timestamp  integer required
Creation timestamp (in ms since Unix epoch)

result.maker_order. direction  string required
Order direction
enum buy sell

result.maker_order. filled_amount  string required
Total filled amount for the order

result.maker_order. instrument_name  string required
Instrument name

result.maker_order. is_transfer  boolean required
Whether the order was generated through private/transfer_position

result.maker_order. label  string required
Optional user-defined label for the order

result.maker_order. last_update_timestamp  integer required
Last update timestamp (in ms since Unix epoch)

result.maker_order. limit_price  string required
Limit price in quote currency

result.maker_order. max_fee  string required
Max fee in units of the quote currency

result.maker_order. mmp  boolean required
Whether the order is tagged for market maker protections

result.maker_order. nonce  integer required
Unique nonce defined as (UTC_timestamp in ms)(random_number_up_to_3_digits) (e.g. 1695836058725001, where 001 is the random number)

result.maker_order. order_fee  string required
Total order fee paid so far

result.maker_order. order_id  string required
Order ID

result.maker_order. order_status  string required
Order status
enum open filled cancelled expired untriggered

result.maker_order. order_type  string required
Order type
enum limit market

result.maker_order. quote_id  string or null required
Quote ID if the trade was executed via RFQ

result.maker_order. signature  string required
Ethereum signature of the order

result.maker_order. signature_expiry_sec  integer required
Signature expiry timestamp

result.maker_order. signer  string required
Owner wallet address or registered session key that signed order

result.maker_order. subaccount_id  integer required
Subaccount ID

result.maker_order. time_in_force  string required
Time in force
enum gtc post_only fok ioc

result.maker_order. replaced_order_id  string or null
If replaced, ID of the order that was replaced

result.maker_order. trigger_price  string or null
(Required for trigger orders) Index or Market price to trigger order at

result.maker_order. trigger_price_type  string or null
(Required for trigger orders) Trigger with Index or Mark Price
enum mark index

result.maker_order. trigger_reject_message  string or null
(Required for trigger orders) Error message if error occured during trigger

result.maker_order. trigger_type  string or null
(Required for trigger orders) Stop-loss or Take-profit.
enum stoploss takeprofit

result. maker_trade  object required

result.maker_trade. direction  string required
Order direction
enum buy sell

result.maker_trade. expected_rebate  string required
Expected rebate for this trade

result.maker_trade. index_price  string required
Index price of the underlying at the time of the trade

result.maker_trade. instrument_name  string required
Instrument name

result.maker_trade. is_transfer  boolean required
Whether the trade was generated through private/transfer_position

result.maker_trade. label  string required
Optional user-defined label for the order

result.maker_trade. liquidity_role  string required
Role of the user in the trade
enum maker taker

result.maker_trade. mark_price  string required
Mark price of the instrument at the time of the trade

result.maker_trade. order_id  string required
Order ID

result.maker_trade. quote_id  string or null required
Quote ID if the trade was executed via RFQ

result.maker_trade. realized_pnl  string required
Realized PnL for this trade

result.maker_trade. realized_pnl_excl_fees  string required
Realized PnL for this trade using cost accounting that excludes fees

result.maker_trade. subaccount_id  integer required
Subaccount ID

result.maker_trade. timestamp  integer required
Trade timestamp (in ms since Unix epoch)

result.maker_trade. trade_amount  string required
Amount filled in this trade

result.maker_trade. trade_fee  string required
Fee for this trade

result.maker_trade. trade_id  string required
Trade ID

result.maker_trade. trade_price  string required
Price at which the trade was filled

result.maker_trade. transaction_id  string required
The transaction id of the related settlement transaction

result.maker_trade. tx_hash  string or null required
Blockchain transaction hash

result.maker_trade. tx_status  string required
Blockchain transaction status
enum requested pending settled reverted ignored timed_out

result. taker_order  object required

result.taker_order. amount  string required
Order amount in units of the base

result.taker_order. average_price  string required
Average fill price

result.taker_order. cancel_reason  string required
If cancelled, reason behind order cancellation
enum user_request mmp_trigger insufficient_margin signed_max_fee_too_low cancel_on_disconnect ioc_or_market_partial_fill session_key_deregistered subaccount_withdrawn compliance trigger_failed validation_failed

result.taker_order. creation_timestamp  integer required
Creation timestamp (in ms since Unix epoch)

result.taker_order. direction  string required
Order direction
enum buy sell

result.taker_order. filled_amount  string required
Total filled amount for the order

result.taker_order. instrument_name  string required
Instrument name

result.taker_order. is_transfer  boolean required
Whether the order was generated through private/transfer_position

result.taker_order. label  string required
Optional user-defined label for the order

result.taker_order. last_update_timestamp  integer required
Last update timestamp (in ms since Unix epoch)

result.taker_order. limit_price  string required
Limit price in quote currency

result.taker_order. max_fee  string required
Max fee in units of the quote currency

result.taker_order. mmp  boolean required
Whether the order is tagged for market maker protections

result.taker_order. nonce  integer required
Unique nonce defined as (UTC_timestamp in ms)(random_number_up_to_3_digits) (e.g. 1695836058725001, where 001 is the random number)

result.taker_order. order_fee  string required
Total order fee paid so far

result.taker_order. order_id  string required
Order ID

result.taker_order. order_status  string required
Order status
enum open filled cancelled expired untriggered

result.taker_order. order_type  string required
Order type
enum limit market

result.taker_order. quote_id  string or null required
Quote ID if the trade was executed via RFQ

result.taker_order. signature  string required
Ethereum signature of the order

result.taker_order. signature_expiry_sec  integer required
Signature expiry timestamp

result.taker_order. signer  string required
Owner wallet address or registered session key that signed order

result.taker_order. subaccount_id  integer required
Subaccount ID

result.taker_order. time_in_force  string required
Time in force
enum gtc post_only fok ioc

result.taker_order. replaced_order_id  string or null
If replaced, ID of the order that was replaced

result.taker_order. trigger_price  string or null
(Required for trigger orders) Index or Market price to trigger order at

result.taker_order. trigger_price_type  string or null
(Required for trigger orders) Trigger with Index or Mark Price
enum mark index

result.taker_order. trigger_reject_message  string or null
(Required for trigger orders) Error message if error occured during trigger

result.taker_order. trigger_type  string or null
(Required for trigger orders) Stop-loss or Take-profit.
enum stoploss takeprofit

result. taker_trade  object required

result.taker_trade. direction  string required
Order direction
enum buy sell

result.taker_trade. expected_rebate  string required
Expected rebate for this trade

result.taker_trade. index_price  string required
Index price of the underlying at the time of the trade

result.taker_trade. instrument_name  string required
Instrument name

result.taker_trade. is_transfer  boolean required
Whether the trade was generated through private/transfer_position

result.taker_trade. label  string required
Optional user-defined label for the order

result.taker_trade. liquidity_role  string required
Role of the user in the trade
enum maker taker

result.taker_trade. mark_price  string required
Mark price of the instrument at the time of the trade

result.taker_trade. order_id  string required
Order ID

result.taker_trade. quote_id  string or null required
Quote ID if the trade was executed via RFQ

result.taker_trade. realized_pnl  string required
Realized PnL for this trade

result.taker_trade. realized_pnl_excl_fees  string required
Realized PnL for this trade using cost accounting that excludes fees

result.taker_trade. subaccount_id  integer required
Subaccount ID

result.taker_trade. timestamp  integer required
Trade timestamp (in ms since Unix epoch)

result.taker_trade. trade_amount  string required
Amount filled in this trade

result.taker_trade. trade_fee  string required
Fee for this trade

result.taker_trade. trade_id  string required
Trade ID

result.taker_trade. trade_price  string required
Price at which the trade was filled

result.taker_trade. transaction_id  string required
The transaction id of the related settlement transaction

result.taker_trade. tx_hash  string or null required
Blockchain transaction hash

result.taker_trade. tx_status  string required
Blockchain transaction status
enum requested pending settled reverted ignored timed_out