asset

Documentation

Index

• type Asset
  • func New(client *client.Client) Asset
• type AssetInfoEntry
• type CancelWithdrawalRequest
• type CancelWithdrawalResponse
• type CoinBalanceEntry
• type CoinChainInfo
• type CoinExchangeRecord
• type CoinInfoEntry
• type CreateInternalTransferRequest
• type CreateInternalTransferResponse
• type CreateUniversalTransferRequest
• type CreateUniversalTransferResponse
• type DeliveryRecordEntry
• type DepositChainInfo
• type DepositConfig
• type DepositRecordEntry
• type GetAllCoinsBalanceRequest
• type GetAllCoinsBalanceResponse
• type GetAllowedDepositCoinInfoRequest
• type GetAllowedDepositCoinInfoResponse
• type GetAssetInfoRequest
• type GetAssetInfoResponse
• type GetCoinExchangeRecordsRequest
• type GetCoinExchangeRecordsResponse
• type GetCoinInfoResponse
• type GetDeliveryRecordRequest
• type GetDeliveryRecordResponse
• type GetDepositRecordsRequest
• type GetDepositRecordsResponse
• type GetInternalDepositRecordsRequest
• type GetInternalDepositRecordsResponse
• type GetInternalTransferRecordsRequest
• type GetInternalTransferRecordsResponse
• type GetMasterDepositAddressRequest
• type GetMasterDepositAddressResponse
• type GetSessionSettlementRecordRequest
• type GetSessionSettlementRecordResponse
• type GetSingleCoinBalanceRequest
• type GetSingleCoinBalanceResponse
• type GetSubDepositAddressRequest
• type GetSubDepositAddressResponse
• type GetSubDepositRecordsRequest
• type GetSubDepositRecordsResponse
• type GetSubUIDsResponse
• type GetTransferableCoinRequest
• type GetTransferableCoinResponse
• type GetUniversalTransferRecordsRequest
• type GetUniversalTransferRecordsResponse
• type GetWithdrawableAmountRequest
• type GetWithdrawableAmountResponse
• type GetWithdrawalRecordsRequest
• type GetWithdrawalRecordsResponse
• type InternalDepositRecordEntry
• type InternalTransferRecordEntry
• type SessionSettlementRecord
• type SetDepositAccountRequest
• type SetDepositAccountResponse
• type SingleCoinBalanceEntry
• type SubDepositChainInfo
• type UniversalTransferRecordEntry
• type WalletWithdrawableAmount
• type WithdrawRequest
• type WithdrawResponse
• type WithdrawalRecord

Types

type Asset

type Asset interface {
	// GetCoinExchangeRecords queries the coin exchange records.
	GetCoinExchangeRecords(req *GetCoinExchangeRecordsRequest) (*GetCoinExchangeRecordsResponse, error)
	// GetDeliveryRecords queries the delivery records of USDC futures and Options.
	GetDeliveryRecords(req *GetDeliveryRecordRequest) (*GetDeliveryRecordResponse, error)
	// GetSessionSettlementRecords queries the session settlement records of USDC perpetual and futures.
	GetSessionSettlementRecords(req *GetSessionSettlementRecordRequest) (*GetSessionSettlementRecordResponse, error)
	// GetAssetInfo queries the asset information for SPOT accounts.
	GetAssetInfo(req *GetAssetInfoRequest) (*GetAssetInfoResponse, error)
	// GetAllCoinsBalance retrieves all coin balances for specified account types.
	GetAllCoinsBalance(req *GetAllCoinsBalanceRequest) (*GetAllCoinsBalanceResponse, error)
	// GetSingleCoinBalance queries the balance of a specific coin in a specific account type.
	GetSingleCoinBalance(req *GetSingleCoinBalanceRequest) (*GetSingleCoinBalanceResponse, error)
	// GetTransferableCoin queries the list of transferable coins between account types.
	GetTransferableCoin(req *GetTransferableCoinRequest) (*GetTransferableCoinResponse, error)
	CreateInternalTransfer(req *CreateInternalTransferRequest) (*CreateInternalTransferResponse, error)
	GetInternalTransferRecords(req *GetInternalTransferRecordsRequest) (*GetInternalTransferRecordsResponse, error)
	GetSubUIDs() (*GetSubUIDsResponse, error)
	CreateUniversalTransfer(req *CreateUniversalTransferRequest) (*CreateUniversalTransferResponse, error)
	GetUniversalTransferRecords(req *GetUniversalTransferRecordsRequest) (*GetUniversalTransferRecordsResponse, error)
	GetAllowedDepositCoinInfo(req *GetAllowedDepositCoinInfoRequest) (*GetAllowedDepositCoinInfoResponse, error)
	GetDepositRecords(req *GetDepositRecordsRequest) (*GetDepositRecordsResponse, error)
	GetSubDepositRecords(req *GetSubDepositRecordsRequest) (*GetSubDepositRecordsResponse, error)
	GetInternalDepositRecords(req *GetInternalDepositRecordsRequest) (*GetInternalDepositRecordsResponse, error)
	GetMasterDepositAddress(req *GetMasterDepositAddressRequest) (*GetMasterDepositAddressResponse, error)
	GetSubDepositAddress(req *GetSubDepositAddressRequest) (*GetSubDepositAddressResponse, error)
	GetCoinInfo(coin *string) (*GetCoinInfoResponse, error)
	GetWithdrawalRecords(req *GetWithdrawalRecordsRequest) (*GetWithdrawalRecordsResponse, error)
	GetWithdrawableAmount(req *GetWithdrawableAmountRequest) (*GetWithdrawableAmountResponse, error)
	Withdraw(req *WithdrawRequest) (*WithdrawResponse, error)
	CancelWithdrawal(req *CancelWithdrawalRequest) (*CancelWithdrawalResponse, error)
}

func New

func New(client *client.Client) Asset

type AssetInfoEntry

type AssetInfoEntry struct {
	Coin     string `json:"coin"`     // Coin
	Frozen   string `json:"frozen"`   // Freeze amount
	Free     string `json:"free"`     // Free balance
	Withdraw string `json:"withdraw"` // Amount in withdrawing
}

AssetInfoEntry represents a single asset entry within the asset information list.

type CancelWithdrawalRequest

type CancelWithdrawalRequest struct {
	ID string `json:"id"` // Required: Withdrawal ID
}

type CancelWithdrawalResponse

type CancelWithdrawalResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Status int `json:"status"` // 0: fail, 1: success
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type CoinBalanceEntry

type CoinBalanceEntry struct {
	Coin            string `json:"coin"`            // Currency type
	WalletBalance   string `json:"walletBalance"`   // Wallet balance
	TransferBalance string `json:"transferBalance"` // Transferable balance
	Bonus           string `json:"bonus,omitempty"` // The bonus (if queried)
}

CoinBalanceEntry represents a single coin's balance information.

type CoinChainInfo

type CoinChainInfo struct {
	Chain                 string `json:"chain"`
	ChainType             string `json:"chainType"`
	Confirmation          string `json:"confirmation"`
	WithdrawFee           string `json:"withdrawFee"`
	DepositMin            string `json:"depositMin"`
	WithdrawMin           string `json:"withdrawMin"`
	MinAccuracy           string `json:"minAccuracy"`
	ChainDeposit          string `json:"chainDeposit"`
	ChainWithdraw         string `json:"chainWithdraw"`
	WithdrawPercentageFee string `json:"withdrawPercentageFee"`
}

type CoinExchangeRecord

type CoinExchangeRecord struct {
	FromCoin     string `json:"fromCoin"`
	FromAmount   string `json:"fromAmount"`
	ToCoin       string `json:"toCoin"`
	ToAmount     string `json:"toAmount"`
	ExchangeRate string `json:"exchangeRate"`
	CreatedTime  string `json:"createdTime"`
	ExchangeTxId string `json:"exchangeTxId"`
}

CoinExchangeRecord represents a single record of a coin exchange.

type CoinInfoEntry

type CoinInfoEntry struct {
	Name         string          `json:"name"`
	Coin         string          `json:"coin"`
	RemainAmount string          `json:"remainAmount"`
	Chains       []CoinChainInfo `json:"chains"`
}

type CreateInternalTransferRequest

type CreateInternalTransferRequest struct {
	TransferID      string `json:"transferId"`      // Required: UUID, manually generate a UUID
	Coin            string `json:"coin"`            // Required: Coin
	Amount          string `json:"amount"`          // Required: Amount
	FromAccountType string `json:"fromAccountType"` // Required: From account type
	ToAccountType   string `json:"toAccountType"`   // Required: To account type
}

CreateInternalTransferRequest represents the payload for creating an internal transfer.

type CreateInternalTransferResponse

type CreateInternalTransferResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		TransferID string `json:"transferId"` // UUID
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

CreateInternalTransferResponse represents the response from creating an internal transfer.

type CreateUniversalTransferRequest

type CreateUniversalTransferRequest struct {
	TransferID      string `json:"transferId"`      // Required: UUID, manually generate a UUID
	Coin            string `json:"coin"`            // Required: Coin
	Amount          string `json:"amount"`          // Required: Amount
	FromMemberID    int    `json:"fromMemberId"`    // Required: From UID
	ToMemberID      int    `json:"toMemberId"`      // Required: To UID
	FromAccountType string `json:"fromAccountType"` // Required: From account type
	ToAccountType   string `json:"toAccountType"`   // Required: To account type
}

CreateUniversalTransferRequest represents the payload for creating a universal transfer.

type CreateUniversalTransferResponse

type CreateUniversalTransferResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		TransferID string `json:"transferId"` // UUID
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

CreateUniversalTransferResponse represents the response from creating a universal transfer.

type DeliveryRecordEntry

type DeliveryRecordEntry struct {
	DeliveryTime  int64  `json:"deliveryTime"`  // Delivery time (ms)
	Symbol        string `json:"symbol"`        // Symbol name
	Side          string `json:"side"`          // Buy, Sell
	Position      string `json:"position"`      // Executed size
	DeliveryPrice string `json:"deliveryPrice"` // Delivery price
	Strike        string `json:"strike"`        // Exercise price
	Fee           string `json:"fee"`           // Trading fee
	DeliveryRpl   string `json:"deliveryRpl"`   // Realized PnL of the delivery
}

DeliveryRecordEntry represents a single entry in the delivery record list.

type DepositChainInfo

type DepositChainInfo struct {
	ChainType         string `json:"chainType"`
	AddressDeposit    string `json:"addressDeposit"`
	TagDeposit        string `json:"tagDeposit"`
	Chain             string `json:"chain"`
	BatchReleaseLimit string `json:"batchReleaseLimit"`
}

type DepositConfig

type DepositConfig struct {
	Coin               string `json:"coin"`
	Chain              string `json:"chain"`
	CoinShowName       string `json:"coinShowName"`
	ChainType          string `json:"chainType"`
	BlockConfirmNumber int    `json:"blockConfirmNumber"`
	MinDepositAmount   string `json:"minDepositAmount"`
}

type DepositRecordEntry

type DepositRecordEntry struct {
	Coin              string `json:"coin"`
	Chain             string `json:"chain"`
	Amount            string `json:"amount"`
	TxID              string `json:"txID"`
	Status            int    `json:"status"`
	ToAddress         string `json:"toAddress"`
	Tag               string `json:"tag"`
	DepositFee        string `json:"depositFee"`
	SuccessAt         string `json:"successAt"`
	Confirmations     string `json:"confirmations"`
	TxIndex           string `json:"txIndex"`
	BlockHash         string `json:"blockHash"`
	BatchReleaseLimit string `json:"batchReleaseLimit"`
	DepositType       int    `json:"depositType"`
}

type GetAllCoinsBalanceRequest

type GetAllCoinsBalanceRequest struct {
	MemberID    *string `json:"memberId,omitempty"`  // Optional: User Id, required for checking sub account coin balance with master API key
	AccountType string  `json:"accountType"`         // Required: Account type
	Coin        *string `json:"coin,omitempty"`      // Optional: Coin name(s), multiple coins separated by comma
	WithBonus   *int    `json:"withBonus,omitempty"` // Optional: 0(default): not query bonus. 1: query bonus
}

GetAllCoinsBalanceRequest represents the query parameters for fetching all coins' balances.

type GetAllCoinsBalanceResponse

type GetAllCoinsBalanceResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		MemberID    string             `json:"memberId"`    // UserID
		AccountType string             `json:"accountType"` // Account type
		Balance     []CoinBalanceEntry `json:"balance"`     // Array of balance entries
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetAllCoinsBalanceResponse represents the response from fetching all coins' balances.

type GetAllowedDepositCoinInfoRequest

type GetAllowedDepositCoinInfoRequest struct {
	Coin   *string `json:"coin,omitempty"`   // Optional: Coin. coin and chain must be paired if passed
	Chain  *string `json:"chain,omitempty"`  // Optional: Chain. coin and chain must be paired if passed
	Limit  *int    `json:"limit,omitempty"`  // Optional: Limit for data size per page
	Cursor *string `json:"cursor,omitempty"` // Optional: Pagination cursor
}

type GetAllowedDepositCoinInfoResponse

type GetAllowedDepositCoinInfoResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		ConfigList     []DepositConfig `json:"configList"`
		NextPageCursor string          `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetAssetInfoRequest

type GetAssetInfoRequest struct {
	AccountType string  `json:"accountType"`    // Required: Account type, e.g., "SPOT"
	Coin        *string `json:"coin,omitempty"` // Optional: Coin name
}

GetAssetInfoRequest represents the query parameters for fetching asset information.

type GetAssetInfoResponse

type GetAssetInfoResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Spot struct {
			Status string           `json:"status"` // account status
			Assets []AssetInfoEntry `json:"assets"` // Assets array
		} `json:"spot"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetAssetInfoResponse represents the response from fetching asset information.

type GetCoinExchangeRecordsRequest

type GetCoinExchangeRecordsRequest struct {
	FromCoin *string `json:"fromCoin,omitempty"` // Optional: The currency to convert from
	ToCoin   *string `json:"toCoin,omitempty"`   // Optional: The currency to convert to
	Limit    *int    `json:"limit,omitempty"`    // Optional: Limit for data size per page
	Cursor   *string `json:"cursor,omitempty"`   // Optional: Cursor for pagination
}

GetCoinExchangeRecordsRequest represents the query parameters for fetching coin exchange records.

type GetCoinExchangeRecordsResponse

type GetCoinExchangeRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		OrderBody      []CoinExchangeRecord `json:"orderBody"`
		NextPageCursor string               `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetCoinExchangeRecordsResponse represents the response from fetching coin exchange records.

type GetCoinInfoResponse

type GetCoinInfoResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Rows []CoinInfoEntry `json:"rows"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetDeliveryRecordRequest

type GetDeliveryRecordRequest struct {
	Category  string  `json:"category"`            // Required: Product type. option, linear
	Symbol    *string `json:"symbol,omitempty"`    // Optional: Symbol name
	StartTime *int64  `json:"startTime,omitempty"` // Optional: Start timestamp (ms)
	EndTime   *int64  `json:"endTime,omitempty"`   // Optional: End time. timestamp (ms)
	ExpDate   *string `json:"expDate,omitempty"`   // Optional: Expiry date. 25MAR22
	Limit     *int    `json:"limit,omitempty"`     // Optional: Limit for data size per page
	Cursor    *string `json:"cursor,omitempty"`    // Optional: Cursor for pagination
}

GetDeliveryRecordRequest represents the query parameters for fetching delivery records.

type GetDeliveryRecordResponse

type GetDeliveryRecordResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		NextPageCursor string                `json:"nextPageCursor"`
		Category       string                `json:"category"`
		List           []DeliveryRecordEntry `json:"list"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetDeliveryRecordResponse represents the response from fetching delivery records.

type GetDepositRecordsRequest

type GetDepositRecordsRequest struct {
	Coin      *string `json:"coin,omitempty"`      // Optional: Coin
	StartTime *int64  `json:"startTime,omitempty"` // Optional: The start timestamp (ms)
	EndTime   *int64  `json:"endTime,omitempty"`   // Optional: The end timestamp (ms)
	Limit     *int    `json:"limit,omitempty"`     // Optional: Limit for data size per page
	Cursor    *string `json:"cursor,omitempty"`    // Optional: Pagination cursor
}

type GetDepositRecordsResponse

type GetDepositRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Rows           []DepositRecordEntry `json:"rows"`
		NextPageCursor string               `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetInternalDepositRecordsRequest

type GetInternalDepositRecordsRequest struct {
	TxID      *string `json:"txID,omitempty"`      // Optional: Internal transfer transaction ID
	StartTime *int64  `json:"startTime,omitempty"` // Optional: Start time (ms)
	EndTime   *int64  `json:"endTime,omitempty"`   // Optional: End time (ms)
	Coin      *string `json:"coin,omitempty"`      // Optional: Coin name
	Cursor    *string `json:"cursor,omitempty"`    // Optional: Pagination cursor
	Limit     *int    `json:"limit,omitempty"`     // Optional: Number of items per page
}

type GetInternalDepositRecordsResponse

type GetInternalDepositRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Rows           []InternalDepositRecordEntry `json:"rows"`
		NextPageCursor string                       `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetInternalTransferRecordsRequest

type GetInternalTransferRecordsRequest struct {
	TransferID *string `json:"transferId,omitempty"` // Optional: UUID used in createTransfer
	Coin       *string `json:"coin,omitempty"`       // Optional: Coin
	Status     *string `json:"status,omitempty"`     // Optional: Transfer status
	StartTime  *int64  `json:"startTime,omitempty"`  // Optional: Start timestamp (ms)
	EndTime    *int64  `json:"endTime,omitempty"`    // Optional: End timestamp (ms)
	Limit      *int    `json:"limit,omitempty"`      // Optional: Data size limit per page
	Cursor     *string `json:"cursor,omitempty"`     // Optional: Pagination cursor
}

GetInternalTransferRecordsRequest represents the query parameters for fetching internal transfer records.

type GetInternalTransferRecordsResponse

type GetInternalTransferRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		List           []InternalTransferRecordEntry `json:"list"`
		NextPageCursor string                        `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetInternalTransferRecordsResponse represents the response from fetching internal transfer records.

type GetMasterDepositAddressRequest

type GetMasterDepositAddressRequest struct {
	Coin      string  `json:"coin"`                // Required: Coin
	ChainType *string `json:"chainType,omitempty"` // Optional: Chain type from coin-info endpoint
}

type GetMasterDepositAddressResponse

type GetMasterDepositAddressResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Coin   string             `json:"coin"`
		Chains []DepositChainInfo `json:"chains"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetSessionSettlementRecordRequest

type GetSessionSettlementRecordRequest struct {
	Category  string  `json:"category"`            // Required: Product type, e.g., "linear"
	Symbol    *string `json:"symbol,omitempty"`    // Optional: Symbol name
	StartTime *int64  `json:"startTime,omitempty"` // Optional: Start timestamp (ms)
	EndTime   *int64  `json:"endTime,omitempty"`   // Optional: End time (ms)
	Limit     *int    `json:"limit,omitempty"`     // Optional: Limit for data size per page
	Cursor    *string `json:"cursor,omitempty"`    // Optional: Cursor for pagination
}

GetSessionSettlementRecordRequest represents the query parameters for fetching session settlement records.

type GetSessionSettlementRecordResponse

type GetSessionSettlementRecordResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		NextPageCursor string                    `json:"nextPageCursor"`
		Category       string                    `json:"category"`
		List           []SessionSettlementRecord `json:"list"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetSessionSettlementRecordResponse represents the response from fetching session settlement records.

type GetSingleCoinBalanceRequest

type GetSingleCoinBalanceRequest struct {
	MemberID                  *string `json:"memberId,omitempty"`                  // Optional: UID, required for querying sub UID balance with master API key
	ToMemberID                *string `json:"toMemberId,omitempty"`                // Optional: UID, required for querying transferable balance between UIDs
	AccountType               string  `json:"accountType"`                         // Required: Account type
	ToAccountType             *string `json:"toAccountType,omitempty"`             // Optional: To account type, required for transferable balance queries
	Coin                      string  `json:"coin"`                                // Required: Coin
	WithBonus                 *int    `json:"withBonus,omitempty"`                 // Optional: Query bonus
	WithTransferSafeAmount    *int    `json:"withTransferSafeAmount,omitempty"`    // Optional: Query delay withdraw/transfer safe amount
	WithLtvTransferSafeAmount *int    `json:"withLtvTransferSafeAmount,omitempty"` // Optional: Query transferable amount for ins loan account
}

GetSingleCoinBalanceRequest represents the query parameters for fetching a single coin balance.

type GetSingleCoinBalanceResponse

type GetSingleCoinBalanceResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		AccountType string                 `json:"accountType"`
		BizType     int                    `json:"bizType"`
		AccountID   string                 `json:"accountId"`
		MemberID    string                 `json:"memberId"`
		Balance     SingleCoinBalanceEntry `json:"balance"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetSingleCoinBalanceResponse represents the response from fetching a single coin balance.

type GetSubDepositAddressRequest

type GetSubDepositAddressRequest struct {
	Coin        string `json:"coin"`        // Required: Coin
	ChainType   string `json:"chainType"`   // Required: Chain type from the coin-info endpoint
	SubMemberId string `json:"subMemberId"` // Required: Sub user ID
}

type GetSubDepositAddressResponse

type GetSubDepositAddressResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Coin   string                `json:"coin"`
		Chains []SubDepositChainInfo `json:"chains"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetSubDepositRecordsRequest

type GetSubDepositRecordsRequest struct {
	SubMemberId string  `json:"subMemberId"`         // Required: Sub UID
	Coin        *string `json:"coin,omitempty"`      // Optional: Coin
	StartTime   *int64  `json:"startTime,omitempty"` // Optional: The start timestamp (ms)
	EndTime     *int64  `json:"endTime,omitempty"`   // Optional: The end timestamp (ms)
	Limit       *int    `json:"limit,omitempty"`     // Optional: Limit for data size per page
	Cursor      *string `json:"cursor,omitempty"`    // Optional: Pagination cursor
}

type GetSubDepositRecordsResponse

type GetSubDepositRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Rows           []DepositRecordEntry `json:"rows"`
		NextPageCursor string               `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetSubUIDsResponse

type GetSubUIDsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		SubMemberIds             []string `json:"subMemberIds"`             // All sub UIDs under the main UID
		TransferableSubMemberIds []string `json:"transferableSubMemberIds"` // All sub UIDs that have universal transfer enabled
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetSubUIDsResponse represents the response from fetching sub UIDs.

type GetTransferableCoinRequest

type GetTransferableCoinRequest struct {
	FromAccountType string `json:"fromAccountType"` // Required: From account type
	ToAccountType   string `json:"toAccountType"`   // Required: To account type
}

GetTransferableCoinRequest represents the query parameters for fetching the transferable coin list.

type GetTransferableCoinResponse

type GetTransferableCoinResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		List []string `json:"list"` // A list of coins
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetTransferableCoinResponse represents the response from fetching the transferable coin list.

type GetUniversalTransferRecordsRequest

type GetUniversalTransferRecordsRequest struct {
	TransferID *string `json:"transferId,omitempty"` // Optional: UUID used in createTransfer
	Coin       *string `json:"coin,omitempty"`       // Optional: Coin
	Status     *string `json:"status,omitempty"`     // Optional: Transfer status (SUCCESS, FAILED, PENDING)
	StartTime  *int64  `json:"startTime,omitempty"`  // Optional: Start timestamp (ms)
	EndTime    *int64  `json:"endTime,omitempty"`    // Optional: End timestamp (ms)
	Limit      *int    `json:"limit,omitempty"`      // Optional: Data size limit per page
	Cursor     *string `json:"cursor,omitempty"`     // Optional: Pagination cursor
}

GetUniversalTransferRecordsRequest represents the query parameters for fetching universal transfer records.

type GetUniversalTransferRecordsResponse

type GetUniversalTransferRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		List           []UniversalTransferRecordEntry `json:"list"`
		NextPageCursor string                         `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

GetUniversalTransferRecordsResponse represents the response from fetching universal transfer records.

type GetWithdrawableAmountRequest

type GetWithdrawableAmountRequest struct {
	Coin string `json:"coin"` // Required: Coin name
}

type GetWithdrawableAmountResponse

type GetWithdrawableAmountResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		LimitAmountUsd     string                              `json:"limitAmountUsd"`
		WithdrawableAmount map[string]WalletWithdrawableAmount `json:"withdrawableAmount"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type GetWithdrawalRecordsRequest

type GetWithdrawalRecordsRequest struct {
	WithdrawID   *string `json:"withdrawID,omitempty"`
	TxID         *string `json:"txID,omitempty"`
	Coin         *string `json:"coin,omitempty"`
	WithdrawType *int    `json:"withdrawType,omitempty"` // 0: on chain, 1: off chain, 2: all
	StartTime    *int64  `json:"startTime,omitempty"`
	EndTime      *int64  `json:"endTime,omitempty"`
	Limit        *int    `json:"limit,omitempty"`
	Cursor       *string `json:"cursor,omitempty"`
}

type GetWithdrawalRecordsResponse

type GetWithdrawalRecordsResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Rows           []WithdrawalRecord `json:"rows"`
		NextPageCursor string             `json:"nextPageCursor"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type InternalDepositRecordEntry

type InternalDepositRecordEntry struct {
	ID          string `json:"id"`
	Type        int    `json:"type"`
	Coin        string `json:"coin"`
	Amount      string `json:"amount"`
	Status      int    `json:"status"`
	Address     string `json:"address"`
	CreatedTime string `json:"createdTime"`
	TxID        string `json:"txID"`
}

type InternalTransferRecordEntry

type InternalTransferRecordEntry struct {
	TransferID      string `json:"transferId"`
	Coin            string `json:"coin"`
	Amount          string `json:"amount"`
	FromAccountType string `json:"fromAccountType"`
	ToAccountType   string `json:"toAccountType"`
	Timestamp       string `json:"timestamp"`
	Status          string `json:"status"`
}

InternalTransferRecordEntry represents a single entry in the internal transfer record list.

type SessionSettlementRecord

type SessionSettlementRecord struct {
	Symbol          string `json:"symbol"`          // Symbol name
	Side            string `json:"side"`            // Buy or Sell
	Size            string `json:"size"`            // Position size
	SessionAvgPrice string `json:"sessionAvgPrice"` // Settlement price
	MarkPrice       string `json:"markPrice"`       // Mark price
	RealisedPnl     string `json:"realisedPnl"`     // Realised PnL
	CreatedTime     string `json:"createdTime"`     // Created time (ms)
}

SessionSettlementRecord represents a single entry in the session settlement record list.

type SetDepositAccountRequest

type SetDepositAccountRequest struct {
	AccountType string `json:"accountType"` // Required: Account type (UNIFIED, SPOT, OPTION, CONTRACT, FUND)
}

type SetDepositAccountResponse

type SetDepositAccountResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Status int `json:"status"` // Request result: 1 for SUCCESS, 0 for FAIL
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type SingleCoinBalanceEntry

type SingleCoinBalanceEntry struct {
	Coin                  string `json:"coin"`
	WalletBalance         string `json:"walletBalance"`
	TransferBalance       string `json:"transferBalance"`
	Bonus                 string `json:"bonus,omitempty"`
	TransferSafeAmount    string `json:"transferSafeAmount,omitempty"`
	LtvTransferSafeAmount string `json:"ltvTransferSafeAmount,omitempty"`
}

SingleCoinBalanceEntry represents the balance information for a single coin.

type SubDepositChainInfo

type SubDepositChainInfo struct {
	ChainType         string `json:"chainType"`
	AddressDeposit    string `json:"addressDeposit"`
	TagDeposit        string `json:"tagDeposit,omitempty"`
	Chain             string `json:"chain"`
	BatchReleaseLimit string `json:"batchReleaseLimit"`
}

type UniversalTransferRecordEntry

type UniversalTransferRecordEntry struct {
	TransferID      string `json:"transferId"`
	Coin            string `json:"coin"`
	Amount          string `json:"amount"`
	FromMemberID    string `json:"fromMemberId"`
	ToMemberID      string `json:"toMemberId"`
	FromAccountType string `json:"fromAccountType"`
	ToAccountType   string `json:"toAccountType"`
	Timestamp       string `json:"timestamp"`
	Status          string `json:"status"`
}

UniversalTransferRecordEntry represents a single entry in the universal transfer record list.

type WalletWithdrawableAmount

type WalletWithdrawableAmount struct {
	Coin               string `json:"coin"`
	WithdrawableAmount string `json:"withdrawableAmount"`
	AvailableBalance   string `json:"availableBalance"`
}

type WithdrawRequest

type WithdrawRequest struct {
	Coin        string  `json:"coin"`                  // Required
	Chain       *string `json:"chain,omitempty"`       // Optional based on forceChain
	Address     string  `json:"address"`               // Required
	Tag         *string `json:"tag,omitempty"`         // Optional based on the address
	Amount      string  `json:"amount"`                // Required
	Timestamp   int64   `json:"timestamp"`             // Required
	ForceChain  *int    `json:"forceChain,omitempty"`  // Optional
	AccountType *string `json:"accountType,omitempty"` // Optional
	FeeType     *int    `json:"feeType,omitempty"`     // Optional
	RequestId   *string `json:"requestId,omitempty"`   // Optional for idempotency
}

type WithdrawResponse

type WithdrawResponse struct {
	RetCode int    `json:"retCode"`
	RetMsg  string `json:"retMsg"`
	Result  struct {
		Id string `json:"id"`
	} `json:"result"`
	RetExtInfo interface{} `json:"retExtInfo"`
	Time       int64       `json:"time"`
}

type WithdrawalRecord

type WithdrawalRecord struct {
	WithdrawId   string `json:"withdrawId"`
	TxID         string `json:"txID"`
	WithdrawType int    `json:"withdrawType"`
	Coin         string `json:"coin"`
	Chain        string `json:"chain"`
	Amount       string `json:"amount"`
	WithdrawFee  string `json:"withdrawFee"`
	Status       string `json:"status"`
	ToAddress    string `json:"toAddress"`
	Tag          string `json:"tag"`
	CreateTime   string `json:"createTime"`
	UpdateTime   string `json:"updateTime"`
}