Documentation ¶
Index ¶
- Constants
- func CacheExpires(r *http.Response) time.Time
- func CalSignature(apiSecret, payload string) string
- func DebugHttpRequest(r *http.Request)
- func SetAuthHeader(request *http.Request, apiKey APIKey, c *Configuration, ...)
- func Signature(apiSecret, method, path, query, nonce, bodyStr string) string
- type APIClient
- type APIKey
- type APIKeyApiService
- func (a *APIKeyApiService) APIKeyDisable(ctx context.Context, apiKeyID string) (ApiKey, *http.Response, error)
- func (a *APIKeyApiService) APIKeyEnable(ctx context.Context, apiKeyID string) (ApiKey, *http.Response, error)
- func (a *APIKeyApiService) APIKeyGet(ctx context.Context, localVarOptionals map[string]interface{}) ([]ApiKey, *http.Response, error)
- func (a *APIKeyApiService) APIKeyNew(ctx context.Context, localVarOptionals map[string]interface{}) (ApiKey, *http.Response, error)
- func (a *APIKeyApiService) APIKeyRemove(ctx context.Context, apiKeyID string) (InlineResponse200, *http.Response, error)
- type APIResponse
- type AccessToken
- type Affiliate
- type Announcement
- type AnnouncementApiService
- type ApiKey
- type BasicAuth
- type Chat
- type ChatApiService
- func (a *ChatApiService) ChatGet(localVarOptionals map[string]interface{}) ([]Chat, *http.Response, error)
- func (a *ChatApiService) ChatGetChannels() ([]ChatChannel, *http.Response, error)
- func (a *ChatApiService) ChatGetConnected() (ConnectedUsers, *http.Response, error)
- func (a *ChatApiService) ChatNew(ctx context.Context, message string, localVarOptionals map[string]interface{}) (Chat, *http.Response, error)
- type ChatChannel
- type Configuration
- type ConnectedUsers
- type ErrorError
- type Execution
- type ExecutionApiService
- type Funding
- type FundingApiService
- type IndexComposite
- type InlineResponse200
- type Instrument
- type InstrumentApiService
- func (a *InstrumentApiService) InstrumentGet(localVarOptionals map[string]interface{}) ([]Instrument, *http.Response, error)
- func (a *InstrumentApiService) InstrumentGetActive() ([]Instrument, *http.Response, error)
- func (a *InstrumentApiService) InstrumentGetActiveAndIndices() ([]Instrument, *http.Response, error)
- func (a *InstrumentApiService) InstrumentGetActiveIntervals() (InstrumentInterval, *http.Response, error)
- func (a *InstrumentApiService) InstrumentGetCompositeIndex(localVarOptionals map[string]interface{}) ([]IndexComposite, *http.Response, error)
- func (a *InstrumentApiService) InstrumentGetIndices() ([]Instrument, *http.Response, error)
- type InstrumentInterval
- type Insurance
- type InsuranceApiService
- type Leaderboard
- type LeaderboardApiService
- type Liquidation
- type LiquidationApiService
- type Margin
- type ModelError
- type Notification
- type NotificationApiService
- type Order
- type OrderApiService
- func (a *OrderApiService) OrderAmend(ctx context.Context, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
- func (a *OrderApiService) OrderAmendBulk(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
- func (a *OrderApiService) OrderCancel(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
- func (a *OrderApiService) OrderCancelAll(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
- func (a *OrderApiService) OrderCancelAllAfter(ctx context.Context, timeout float64) (interface{}, *http.Response, error)
- func (a *OrderApiService) OrderClosePosition(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
- func (a *OrderApiService) OrderGetOrders(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
- func (a *OrderApiService) OrderNew(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
- func (a *OrderApiService) OrderNewBulk(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
- type OrderBook
- type OrderBookApiService
- type OrderBookL2
- type Position
- type PositionApiService
- func (a *PositionApiService) PositionGet(ctx context.Context, localVarOptionals map[string]interface{}) ([]Position, *http.Response, error)
- func (a *PositionApiService) PositionIsolateMargin(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Position, *http.Response, error)
- func (a *PositionApiService) PositionTransferIsolatedMargin(ctx context.Context, symbol string, amount float32) (Position, *http.Response, error)
- func (a *PositionApiService) PositionUpdateLeverage(ctx context.Context, symbol string, leverage float64) (Position, *http.Response, error)
- func (a *PositionApiService) PositionUpdateRiskLimit(ctx context.Context, symbol string, riskLimit float32) (Position, *http.Response, error)
- type Quote
- type QuoteApiService
- type SchemaApiService
- type Settlement
- type SettlementApiService
- type Stats
- type StatsApiService
- type StatsHistory
- type StatsUsd
- type Trade
- type TradeApiService
- type TradeBin
- type Transaction
- type User
- type UserApiService
- func (a *UserApiService) UserCancelWithdrawal(token string) (Transaction, *http.Response, error)
- func (a *UserApiService) UserCheckReferralCode(localVarOptionals map[string]interface{}) (float64, *http.Response, error)
- func (a *UserApiService) UserConfirm(token string) (AccessToken, *http.Response, error)
- func (a *UserApiService) UserConfirmEnableTFA(ctx context.Context, token string, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
- func (a *UserApiService) UserConfirmWithdrawal(token string) (Transaction, *http.Response, error)
- func (a *UserApiService) UserDisableTFA(ctx context.Context, token string, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
- func (a *UserApiService) UserGet(ctx context.Context) (User, *http.Response, error)
- func (a *UserApiService) UserGetAffiliateStatus(ctx context.Context) (Affiliate, *http.Response, error)
- func (a *UserApiService) UserGetCommission(ctx context.Context) ([]UserCommission, *http.Response, error)
- func (a *UserApiService) UserGetDepositAddress(ctx context.Context, localVarOptionals map[string]interface{}) (string, *http.Response, error)
- func (a *UserApiService) UserGetMargin(ctx context.Context, localVarOptionals map[string]interface{}) (Margin, *http.Response, error)
- func (a *UserApiService) UserGetWallet(ctx context.Context, localVarOptionals map[string]interface{}) (Wallet, *http.Response, error)
- func (a *UserApiService) UserGetWalletHistory(ctx context.Context, localVarOptionals map[string]interface{}) ([]Transaction, *http.Response, error)
- func (a *UserApiService) UserGetWalletSummary(ctx context.Context, localVarOptionals map[string]interface{}) ([]Transaction, *http.Response, error)
- func (a *UserApiService) UserLogout() (*http.Response, error)
- func (a *UserApiService) UserLogoutAll(ctx context.Context) (float64, *http.Response, error)
- func (a *UserApiService) UserMinWithdrawalFee(localVarOptionals map[string]interface{}) (interface{}, *http.Response, error)
- func (a *UserApiService) UserRequestEnableTFA(ctx context.Context, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
- func (a *UserApiService) UserRequestWithdrawal(ctx context.Context, currency string, amount float32, address string, ...) (Transaction, *http.Response, error)
- func (a *UserApiService) UserSavePreferences(ctx context.Context, prefs string, localVarOptionals map[string]interface{}) (User, *http.Response, error)
- func (a *UserApiService) UserUpdate(ctx context.Context, localVarOptionals map[string]interface{}) (User, *http.Response, error)
- type UserCommission
- type UserPreferences
- type Wallet
- type XAny
Constants ¶
const ContextAPIKey int = 4
const ContextAccessToken int = 3
const ContextBasicAuth int = 2
const ContextOAuth2 int = 1
Variables ¶
This section is empty.
Functions ¶
func CacheExpires ¶
CacheExpires helper function to determine remaining time before repeating a request.
func CalSignature ¶
func DebugHttpRequest ¶
Save a copy of this request for debugging.
func SetAuthHeader ¶
Types ¶
type APIClient ¶
type APIClient struct { // API Services APIKeyApi *APIKeyApiService AnnouncementApi *AnnouncementApiService ChatApi *ChatApiService ExecutionApi *ExecutionApiService FundingApi *FundingApiService InstrumentApi *InstrumentApiService InsuranceApi *InsuranceApiService LeaderboardApi *LeaderboardApiService LiquidationApi *LiquidationApiService NotificationApi *NotificationApiService OrderApi *OrderApiService OrderBookApi *OrderBookApiService PositionApi *PositionApiService QuoteApi *QuoteApiService SchemaApi *SchemaApiService SettlementApi *SettlementApiService StatsApi *StatsApiService TradeApi *TradeApiService UserApi *UserApiService // contains filtered or unexported fields }
APIClient manages communication with the BitMEX API API v1.2.0 In most cases there should be only one, shared, APIClient.
func NewAPIClient ¶
func NewAPIClient(cfg *Configuration) *APIClient
NewAPIClient creates a new API client. Requires a userAgent string describing your application. optionally a custom http.Client to allow for advanced features such as caching.
func (*APIClient) ChangeBasePath ¶
Change base path to allow switching to mocks
type APIKeyApiService ¶
type APIKeyApiService service
func (*APIKeyApiService) APIKeyDisable ¶
func (a *APIKeyApiService) APIKeyDisable(ctx context.Context, apiKeyID string) (ApiKey, *http.Response, error)
APIKeyApiService Disable an API Key.
* @param ctx context.Context Authentication Context @param apiKeyID API Key ID (public component). @return ApiKey
func (*APIKeyApiService) APIKeyEnable ¶
func (a *APIKeyApiService) APIKeyEnable(ctx context.Context, apiKeyID string) (ApiKey, *http.Response, error)
APIKeyApiService Enable an API Key.
* @param ctx context.Context Authentication Context @param apiKeyID API Key ID (public component). @return ApiKey
func (*APIKeyApiService) APIKeyGet ¶
func (a *APIKeyApiService) APIKeyGet(ctx context.Context, localVarOptionals map[string]interface{}) ([]ApiKey, *http.Response, error)
APIKeyApiService Get your API Keys.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "reverse" (bool) If true, will sort results newest first.
@return []ApiKey
func (*APIKeyApiService) APIKeyNew ¶
func (a *APIKeyApiService) APIKeyNew(ctx context.Context, localVarOptionals map[string]interface{}) (ApiKey, *http.Response, error)
APIKeyApiService Create a new API Key.
API Keys can also be created via [this Python script](https://github.com/BitMEX/market-maker/blob/master/generate-api-key.py) See the [API Key Documentation](/app/apiKeys) for more information on capabilities. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "name" (string) Key name. This name is for reference only. @param "cidr" (string) CIDR block to restrict this key to. To restrict to a single address, append \"/32\", e.g. 207.39.29.22/32. Leave blank or set to 0.0.0.0/0 to allow all IPs. Only one block may be set. <a href=\"http://software77.net/cidr-101.html\">More on CIDR blocks</a> @param "permissions" (string) Key Permissions. All keys can read margin and position data. Additional permissions must be added. Available: [\"order\", \"orderCancel\", \"withdraw\"]. @param "enabled" (bool) Set to true to enable this key on creation. Otherwise, it must be explicitly enabled via /apiKey/enable. @param "token" (string) OTP Token (YubiKey, Google Authenticator)
@return ApiKey
func (*APIKeyApiService) APIKeyRemove ¶
func (a *APIKeyApiService) APIKeyRemove(ctx context.Context, apiKeyID string) (InlineResponse200, *http.Response, error)
APIKeyApiService Remove an API Key.
* @param ctx context.Context Authentication Context @param apiKeyID API Key ID (public component). @return InlineResponse200
type APIResponse ¶
type APIResponse struct { *http.Response `json:"-"` Message string `json:"message,omitempty"` // Operation is the name of the swagger operation. Operation string `json:"operation,omitempty"` // RequestURL is the request URL. This value is always available, even if the // embedded *http.Response is nil. RequestURL string `json:"url,omitempty"` // Method is the HTTP method used for the request. This value is always // available, even if the embedded *http.Response is nil. Method string `json:"method,omitempty"` // Payload holds the contents of the response body (which may be nil or empty). // This is provided here as the raw response.Body() reader will have already // been drained. Payload []byte `json:"-"` }
func NewAPIResponse ¶
func NewAPIResponse(r *http.Response) *APIResponse
func NewAPIResponseWithError ¶
func NewAPIResponseWithError(errorMessage string) *APIResponse
type AccessToken ¶
type Affiliate ¶
type Affiliate struct { Account float32 `json:"account"` Currency string `json:"currency"` PrevPayout float32 `json:"prevPayout,omitempty"` PrevTurnover float32 `json:"prevTurnover,omitempty"` PrevComm float32 `json:"prevComm,omitempty"` PrevTimestamp time.Time `json:"prevTimestamp,omitempty"` ExecTurnover float32 `json:"execTurnover,omitempty"` ExecComm float32 `json:"execComm,omitempty"` TotalReferrals float32 `json:"totalReferrals,omitempty"` TotalTurnover float32 `json:"totalTurnover,omitempty"` TotalComm float32 `json:"totalComm,omitempty"` PayoutPcnt float64 `json:"payoutPcnt,omitempty"` PendingPayout float32 `json:"pendingPayout,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` ReferrerAccount float64 `json:"referrerAccount,omitempty"` }
type Announcement ¶
type Announcement struct { Id float32 `json:"id"` Link string `json:"link,omitempty"` Title string `json:"title,omitempty"` Content string `json:"content,omitempty"` Date time.Time `json:"date,omitempty"` }
Public Announcements
type AnnouncementApiService ¶
type AnnouncementApiService service
func (*AnnouncementApiService) AnnouncementGet ¶
func (a *AnnouncementApiService) AnnouncementGet(localVarOptionals map[string]interface{}) ([]Announcement, *http.Response, error)
AnnouncementApiService Get site announcements.
@param optional (nil or map[string]interface{}) with one or more of:
@param "columns" (string) Array of column names to fetch. If omitted, will return all columns.
@return []Announcement
func (*AnnouncementApiService) AnnouncementGetUrgent ¶
func (a *AnnouncementApiService) AnnouncementGetUrgent(ctx context.Context) ([]Announcement, *http.Response, error)
AnnouncementApiService Get urgent (banner) announcements. * @param ctx context.Context Authentication Context @return []Announcement
type ApiKey ¶
type ApiKey struct { Id string `json:"id"` Secret string `json:"secret"` Name string `json:"name"` Nonce float32 `json:"nonce"` Cidr string `json:"cidr,omitempty"` Permissions []XAny `json:"permissions,omitempty"` Enabled bool `json:"enabled,omitempty"` UserId float32 `json:"userId"` Created time.Time `json:"created,omitempty"` }
Persistent API Keys for Developers
type Chat ¶
type Chat struct { Id float32 `json:"id,omitempty"` Date time.Time `json:"date"` User string `json:"user"` Message string `json:"message"` Html string `json:"html"` FromBot bool `json:"fromBot,omitempty"` ChannelID float64 `json:"channelID,omitempty"` }
Trollbox Data
type ChatApiService ¶
type ChatApiService service
func (*ChatApiService) ChatGet ¶
func (a *ChatApiService) ChatGet(localVarOptionals map[string]interface{}) ([]Chat, *http.Response, error)
ChatApiService Get chat messages.
@param optional (nil or map[string]interface{}) with one or more of:
@param "count" (float32) Number of results to fetch. @param "start" (float32) Starting ID for results. @param "reverse" (bool) If true, will sort results newest first. @param "channelID" (float64) Channel id. GET /chat/channels for ids. Leave blank for all.
@return []Chat
func (*ChatApiService) ChatGetChannels ¶
func (a *ChatApiService) ChatGetChannels() ([]ChatChannel, *http.Response, error)
ChatApiService Get available channels.
@return []ChatChannel
func (*ChatApiService) ChatGetConnected ¶
func (a *ChatApiService) ChatGetConnected() (ConnectedUsers, *http.Response, error)
ChatApiService Get connected users.
Returns an array with browser users in the first position and API users (bots) in the second position.
@return ConnectedUsers
func (*ChatApiService) ChatNew ¶
func (a *ChatApiService) ChatNew(ctx context.Context, message string, localVarOptionals map[string]interface{}) (Chat, *http.Response, error)
ChatApiService Send a chat message.
* @param ctx context.Context Authentication Context @param message @param optional (nil or map[string]interface{}) with one or more of:
@param "channelID" (float64) Channel to post to. Default 1 (English).
@return Chat
type ChatChannel ¶
type Configuration ¶
type Configuration struct { BasePath string `json:"basePath,omitempty"` Host string `json:"host,omitempty"` Scheme string `json:"scheme,omitempty"` DefaultHeader map[string]string `json:"defaultHeader,omitempty"` UserAgent string `json:"userAgent,omitempty"` HTTPClient *http.Client ExpireTime int64 }
func NewConfiguration ¶
func NewConfiguration() *Configuration
func (*Configuration) AddDefaultHeader ¶
func (c *Configuration) AddDefaultHeader(key string, value string)
type ConnectedUsers ¶
type ErrorError ¶
type Execution ¶
type Execution struct { ExecID string `json:"execID"` OrderID string `json:"orderID,omitempty"` ClOrdID string `json:"clOrdID,omitempty"` ClOrdLinkID string `json:"clOrdLinkID,omitempty"` Account float32 `json:"account,omitempty"` Symbol string `json:"symbol,omitempty"` Side string `json:"side,omitempty"` LastQty float32 `json:"lastQty,omitempty"` LastPx float64 `json:"lastPx,omitempty"` UnderlyingLastPx float64 `json:"underlyingLastPx,omitempty"` LastMkt string `json:"lastMkt,omitempty"` LastLiquidityInd string `json:"lastLiquidityInd,omitempty"` SimpleOrderQty float64 `json:"simpleOrderQty,omitempty"` OrderQty float32 `json:"orderQty,omitempty"` Price float64 `json:"price,omitempty"` DisplayQty float32 `json:"displayQty,omitempty"` StopPx float64 `json:"stopPx,omitempty"` PegOffsetValue float64 `json:"pegOffsetValue,omitempty"` PegPriceType string `json:"pegPriceType,omitempty"` Currency string `json:"currency,omitempty"` SettlCurrency string `json:"settlCurrency,omitempty"` ExecType string `json:"execType,omitempty"` OrdType string `json:"ordType,omitempty"` TimeInForce string `json:"timeInForce,omitempty"` ExecInst string `json:"execInst,omitempty"` ContingencyType string `json:"contingencyType,omitempty"` ExDestination string `json:"exDestination,omitempty"` OrdStatus string `json:"ordStatus,omitempty"` Triggered string `json:"triggered,omitempty"` WorkingIndicator bool `json:"workingIndicator,omitempty"` OrdRejReason string `json:"ordRejReason,omitempty"` SimpleLeavesQty float64 `json:"simpleLeavesQty,omitempty"` LeavesQty float32 `json:"leavesQty,omitempty"` SimpleCumQty float64 `json:"simpleCumQty,omitempty"` CumQty float32 `json:"cumQty,omitempty"` AvgPx float64 `json:"avgPx,omitempty"` Commission float64 `json:"commission,omitempty"` TradePublishIndicator string `json:"tradePublishIndicator,omitempty"` MultiLegReportingType string `json:"multiLegReportingType,omitempty"` Text string `json:"text,omitempty"` TrdMatchID string `json:"trdMatchID,omitempty"` ExecCost float32 `json:"execCost,omitempty"` ExecComm float32 `json:"execComm,omitempty"` HomeNotional float64 `json:"homeNotional,omitempty"` ForeignNotional float64 `json:"foreignNotional,omitempty"` TransactTime time.Time `json:"transactTime,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` }
Raw Order and Balance Data
type ExecutionApiService ¶
type ExecutionApiService service
func (*ExecutionApiService) ExecutionGet ¶
func (a *ExecutionApiService) ExecutionGet(ctx context.Context, localVarOptionals map[string]interface{}) ([]Execution, *http.Response, error)
ExecutionApiService Get all raw executions for your account.
This returns all raw transactions, which includes order opening and cancelation, and order status changes. It can be quite noisy. More focused information is available at `/execution/tradeHistory`. You may also use the `filter` param to target your query. Specify an array as a filter value, such as `{\"execType\": [\"Settlement\", \"Trade\"]}` to filter on multiple values. See [the FIX Spec](http://www.onixs.biz/fix-dictionary/5.0.SP2/msgType_8_8.html) for explanations of these fields. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Execution
func (*ExecutionApiService) ExecutionGetTradeHistory ¶
func (a *ExecutionApiService) ExecutionGetTradeHistory(ctx context.Context, localVarOptionals map[string]interface{}) ([]Execution, *http.Response, error)
ExecutionApiService Get all balance-affecting executions. This includes each trade, insurance charge, and settlement.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Execution
type Funding ¶
type Funding struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol"` FundingInterval time.Time `json:"fundingInterval,omitempty"` FundingRate float64 `json:"fundingRate,omitempty"` FundingRateDaily float64 `json:"fundingRateDaily,omitempty"` }
Swap Funding History
type FundingApiService ¶
type FundingApiService service
func (*FundingApiService) FundingGet ¶
func (a *FundingApiService) FundingGet(localVarOptionals map[string]interface{}) ([]Funding, *http.Response, error)
FundingApiService Get funding history.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Funding
type IndexComposite ¶
type IndexComposite struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol,omitempty"` IndexSymbol string `json:"indexSymbol,omitempty"` Reference string `json:"reference,omitempty"` LastPrice float64 `json:"lastPrice,omitempty"` Weight float64 `json:"weight,omitempty"` Logged time.Time `json:"logged,omitempty"` }
type InlineResponse200 ¶
type InlineResponse200 struct {
Success bool `json:"success,omitempty"`
}
type Instrument ¶
type Instrument struct { Symbol string `json:"symbol"` RootSymbol string `json:"rootSymbol,omitempty"` State string `json:"state,omitempty"` Typ string `json:"typ,omitempty"` Listing time.Time `json:"listing,omitempty"` Front time.Time `json:"front,omitempty"` Expiry time.Time `json:"expiry,omitempty"` Settle time.Time `json:"settle,omitempty"` RelistInterval time.Time `json:"relistInterval,omitempty"` InverseLeg string `json:"inverseLeg,omitempty"` SellLeg string `json:"sellLeg,omitempty"` BuyLeg string `json:"buyLeg,omitempty"` PositionCurrency string `json:"positionCurrency,omitempty"` Underlying string `json:"underlying,omitempty"` QuoteCurrency string `json:"quoteCurrency,omitempty"` UnderlyingSymbol string `json:"underlyingSymbol,omitempty"` Reference string `json:"reference,omitempty"` ReferenceSymbol string `json:"referenceSymbol,omitempty"` CalcInterval time.Time `json:"calcInterval,omitempty"` PublishInterval time.Time `json:"publishInterval,omitempty"` PublishTime time.Time `json:"publishTime,omitempty"` MaxOrderQty float32 `json:"maxOrderQty,omitempty"` MaxPrice float64 `json:"maxPrice,omitempty"` LotSize float32 `json:"lotSize,omitempty"` TickSize float64 `json:"tickSize,omitempty"` Multiplier float32 `json:"multiplier,omitempty"` SettlCurrency string `json:"settlCurrency,omitempty"` UnderlyingToPositionMultiplier float32 `json:"underlyingToPositionMultiplier,omitempty"` UnderlyingToSettleMultiplier float32 `json:"underlyingToSettleMultiplier,omitempty"` QuoteToSettleMultiplier float32 `json:"quoteToSettleMultiplier,omitempty"` IsQuanto bool `json:"isQuanto,omitempty"` IsInverse bool `json:"isInverse,omitempty"` InitMargin float64 `json:"initMargin,omitempty"` MaintMargin float64 `json:"maintMargin,omitempty"` RiskLimit float32 `json:"riskLimit,omitempty"` RiskStep float32 `json:"riskStep,omitempty"` Limit float64 `json:"limit,omitempty"` Capped bool `json:"capped,omitempty"` Taxed bool `json:"taxed,omitempty"` Deleverage bool `json:"deleverage,omitempty"` MakerFee float64 `json:"makerFee,omitempty"` TakerFee float64 `json:"takerFee,omitempty"` SettlementFee float64 `json:"settlementFee,omitempty"` InsuranceFee float64 `json:"insuranceFee,omitempty"` FundingBaseSymbol string `json:"fundingBaseSymbol,omitempty"` FundingQuoteSymbol string `json:"fundingQuoteSymbol,omitempty"` FundingPremiumSymbol string `json:"fundingPremiumSymbol,omitempty"` FundingTimestamp time.Time `json:"fundingTimestamp,omitempty"` FundingInterval time.Time `json:"fundingInterval,omitempty"` FundingRate float64 `json:"fundingRate,omitempty"` IndicativeFundingRate float64 `json:"indicativeFundingRate,omitempty"` RebalanceTimestamp time.Time `json:"rebalanceTimestamp,omitempty"` RebalanceInterval time.Time `json:"rebalanceInterval,omitempty"` OpeningTimestamp time.Time `json:"openingTimestamp,omitempty"` ClosingTimestamp time.Time `json:"closingTimestamp,omitempty"` SessionInterval time.Time `json:"sessionInterval,omitempty"` PrevClosePrice float64 `json:"prevClosePrice,omitempty"` LimitDownPrice float64 `json:"limitDownPrice,omitempty"` LimitUpPrice float64 `json:"limitUpPrice,omitempty"` BankruptLimitDownPrice float64 `json:"bankruptLimitDownPrice,omitempty"` BankruptLimitUpPrice float64 `json:"bankruptLimitUpPrice,omitempty"` PrevTotalVolume float32 `json:"prevTotalVolume,omitempty"` TotalVolume float32 `json:"totalVolume,omitempty"` Volume float32 `json:"volume,omitempty"` Volume24h float32 `json:"volume24h,omitempty"` PrevTotalTurnover float32 `json:"prevTotalTurnover,omitempty"` TotalTurnover float32 `json:"totalTurnover,omitempty"` Turnover float32 `json:"turnover,omitempty"` Turnover24h float32 `json:"turnover24h,omitempty"` PrevPrice24h float64 `json:"prevPrice24h,omitempty"` Vwap float64 `json:"vwap,omitempty"` HighPrice float64 `json:"highPrice,omitempty"` LowPrice float64 `json:"lowPrice,omitempty"` LastPrice float64 `json:"lastPrice,omitempty"` LastPriceProtected float64 `json:"lastPriceProtected,omitempty"` LastTickDirection string `json:"lastTickDirection,omitempty"` LastChangePcnt float64 `json:"lastChangePcnt,omitempty"` BidPrice float64 `json:"bidPrice,omitempty"` MidPrice float64 `json:"midPrice,omitempty"` AskPrice float64 `json:"askPrice,omitempty"` ImpactBidPrice float64 `json:"impactBidPrice,omitempty"` ImpactMidPrice float64 `json:"impactMidPrice,omitempty"` ImpactAskPrice float64 `json:"impactAskPrice,omitempty"` HasLiquidity bool `json:"hasLiquidity,omitempty"` OpenInterest float32 `json:"openInterest,omitempty"` OpenValue float32 `json:"openValue,omitempty"` FairMethod string `json:"fairMethod,omitempty"` FairBasisRate float64 `json:"fairBasisRate,omitempty"` FairBasis float64 `json:"fairBasis,omitempty"` FairPrice float64 `json:"fairPrice,omitempty"` MarkMethod string `json:"markMethod,omitempty"` MarkPrice float64 `json:"markPrice,omitempty"` IndicativeTaxRate float64 `json:"indicativeTaxRate,omitempty"` IndicativeSettlePrice float64 `json:"indicativeSettlePrice,omitempty"` SettledPrice float64 `json:"settledPrice,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` }
Tradeable Contracts, Indices, and History
type InstrumentApiService ¶
type InstrumentApiService service
func (*InstrumentApiService) InstrumentGet ¶
func (a *InstrumentApiService) InstrumentGet(localVarOptionals map[string]interface{}) ([]Instrument, *http.Response, error)
InstrumentApiService Get instruments.
This returns all instruments and indices, including those that have settled or are unlisted. Use this endpoint if you want to query for individual instruments or use a complex filter. Use `/instrument/active` to return active instruments, or use a filter like `{\"state\": \"Open\"}`.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Instrument
func (*InstrumentApiService) InstrumentGetActive ¶
func (a *InstrumentApiService) InstrumentGetActive() ([]Instrument, *http.Response, error)
InstrumentApiService Get all active instruments and instruments that have expired in <24hrs.
@return []Instrument
func (*InstrumentApiService) InstrumentGetActiveAndIndices ¶
func (a *InstrumentApiService) InstrumentGetActiveAndIndices() ([]Instrument, *http.Response, error)
InstrumentApiService Helper method. Gets all active instruments and all indices. This is a join of the result of /indices and /active.
@return []Instrument
func (*InstrumentApiService) InstrumentGetActiveIntervals ¶
func (a *InstrumentApiService) InstrumentGetActiveIntervals() (InstrumentInterval, *http.Response, error)
InstrumentApiService Return all active contract series and interval pairs.
This endpoint is useful for determining which pairs are live. It returns two arrays of strings. The first is intervals, such as `[\"BVOL:daily\", \"BVOL:weekly\", \"XBU:daily\", \"XBU:monthly\", ...]`. These identifiers are usable in any query's `symbol` param. The second array is the current resolution of these intervals. Results are mapped at the same index.
@return InstrumentInterval
func (*InstrumentApiService) InstrumentGetCompositeIndex ¶
func (a *InstrumentApiService) InstrumentGetCompositeIndex(localVarOptionals map[string]interface{}) ([]IndexComposite, *http.Response, error)
InstrumentApiService Show constituent parts of an index.
Composite indices are built from multiple external price sources. Use this endpoint to get the underlying prices of an index. For example, send a `symbol` of `.XBT` to get the ticks and weights of the constituent exchanges that build the \".XBT\" index. A tick with reference `\"BMI\"` and weight `null` is the composite index tick.
@param optional (nil or map[string]interface{}) with one or more of:
@param "account" (float64) @param "symbol" (string) The composite index symbol. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []IndexComposite
func (*InstrumentApiService) InstrumentGetIndices ¶
func (a *InstrumentApiService) InstrumentGetIndices() ([]Instrument, *http.Response, error)
InstrumentApiService Get all price indices.
@return []Instrument
type InstrumentInterval ¶
type Insurance ¶
type Insurance struct { Currency string `json:"currency"` Timestamp time.Time `json:"timestamp"` WalletBalance float32 `json:"walletBalance,omitempty"` }
Insurance Fund Data
type InsuranceApiService ¶
type InsuranceApiService service
func (*InsuranceApiService) InsuranceGet ¶
func (a *InsuranceApiService) InsuranceGet(localVarOptionals map[string]interface{}) ([]Insurance, *http.Response, error)
InsuranceApiService Get insurance fund history.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Insurance
type Leaderboard ¶
type Leaderboard struct { Name string `json:"name"` IsRealName bool `json:"isRealName,omitempty"` IsMe bool `json:"isMe,omitempty"` Profit float64 `json:"profit,omitempty"` }
Information on Top Users
type LeaderboardApiService ¶
type LeaderboardApiService service
func (*LeaderboardApiService) LeaderboardGet ¶
func (a *LeaderboardApiService) LeaderboardGet(localVarOptionals map[string]interface{}) ([]Leaderboard, *http.Response, error)
LeaderboardApiService Get current leaderboard.
@param optional (nil or map[string]interface{}) with one or more of:
@param "method" (string) Ranking type. Options: \"notional\", \"ROE\"
@return []Leaderboard
type Liquidation ¶
type Liquidation struct { OrderID string `json:"orderID"` Symbol string `json:"symbol,omitempty"` Side string `json:"side,omitempty"` Price float64 `json:"price,omitempty"` LeavesQty float32 `json:"leavesQty,omitempty"` }
Active Liquidations
type LiquidationApiService ¶
type LiquidationApiService service
func (*LiquidationApiService) LiquidationGet ¶
func (a *LiquidationApiService) LiquidationGet(localVarOptionals map[string]interface{}) ([]Liquidation, *http.Response, error)
LiquidationApiService Get liquidation orders.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Liquidation
type Margin ¶
type Margin struct { Account float32 `json:"account"` Currency string `json:"currency"` RiskLimit float32 `json:"riskLimit,omitempty"` PrevState string `json:"prevState,omitempty"` State string `json:"state,omitempty"` Action string `json:"action,omitempty"` Amount float32 `json:"amount,omitempty"` PendingCredit float32 `json:"pendingCredit,omitempty"` PendingDebit float32 `json:"pendingDebit,omitempty"` ConfirmedDebit float32 `json:"confirmedDebit,omitempty"` PrevRealisedPnl float32 `json:"prevRealisedPnl,omitempty"` PrevUnrealisedPnl float32 `json:"prevUnrealisedPnl,omitempty"` GrossComm float32 `json:"grossComm,omitempty"` GrossOpenCost float32 `json:"grossOpenCost,omitempty"` GrossOpenPremium float32 `json:"grossOpenPremium,omitempty"` GrossExecCost float32 `json:"grossExecCost,omitempty"` GrossMarkValue float32 `json:"grossMarkValue,omitempty"` RiskValue float32 `json:"riskValue,omitempty"` TaxableMargin float32 `json:"taxableMargin,omitempty"` InitMargin float32 `json:"initMargin,omitempty"` MaintMargin float32 `json:"maintMargin,omitempty"` SessionMargin float32 `json:"sessionMargin,omitempty"` TargetExcessMargin float32 `json:"targetExcessMargin,omitempty"` VarMargin float32 `json:"varMargin,omitempty"` RealisedPnl float32 `json:"realisedPnl,omitempty"` UnrealisedPnl float32 `json:"unrealisedPnl,omitempty"` IndicativeTax float32 `json:"indicativeTax,omitempty"` UnrealisedProfit float32 `json:"unrealisedProfit,omitempty"` SyntheticMargin float32 `json:"syntheticMargin,omitempty"` WalletBalance float32 `json:"walletBalance,omitempty"` MarginBalance float32 `json:"marginBalance,omitempty"` MarginBalancePcnt float64 `json:"marginBalancePcnt,omitempty"` MarginLeverage float64 `json:"marginLeverage,omitempty"` MarginUsedPcnt float64 `json:"marginUsedPcnt,omitempty"` ExcessMargin float32 `json:"excessMargin,omitempty"` ExcessMarginPcnt float64 `json:"excessMarginPcnt,omitempty"` AvailableMargin float32 `json:"availableMargin,omitempty"` WithdrawableMargin float32 `json:"withdrawableMargin,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` GrossLastValue float32 `json:"grossLastValue,omitempty"` Commission float64 `json:"commission,omitempty"` }
type ModelError ¶
type ModelError struct {
Error_ *ErrorError `json:"error,omitempty"`
}
type Notification ¶
type Notification struct { Id float32 `json:"id,omitempty"` Date time.Time `json:"date"` Title string `json:"title"` Body string `json:"body"` Ttl float32 `json:"ttl"` Type_ string `json:"type,omitempty"` Closable bool `json:"closable,omitempty"` Persist bool `json:"persist,omitempty"` WaitForVisibility bool `json:"waitForVisibility,omitempty"` Sound string `json:"sound,omitempty"` }
Account Notifications
type NotificationApiService ¶
type NotificationApiService service
func (*NotificationApiService) NotificationGet ¶
func (a *NotificationApiService) NotificationGet(ctx context.Context) ([]Notification, *http.Response, error)
NotificationApiService Get your current notifications.
This is an upcoming feature and currently does not return data. * @param ctx context.Context Authentication Context @return []Notification
type Order ¶
type Order struct { OrderID string `json:"orderID"` ClOrdID string `json:"clOrdID,omitempty"` ClOrdLinkID string `json:"clOrdLinkID,omitempty"` Account float32 `json:"account,omitempty"` Symbol string `json:"symbol,omitempty"` Side string `json:"side,omitempty"` SimpleOrderQty float64 `json:"simpleOrderQty,omitempty"` OrderQty float32 `json:"orderQty,omitempty"` Price float64 `json:"price,omitempty"` DisplayQty float32 `json:"displayQty,omitempty"` StopPx float64 `json:"stopPx,omitempty"` PegOffsetValue float64 `json:"pegOffsetValue,omitempty"` PegPriceType string `json:"pegPriceType,omitempty"` Currency string `json:"currency,omitempty"` SettlCurrency string `json:"settlCurrency,omitempty"` OrdType string `json:"ordType,omitempty"` TimeInForce string `json:"timeInForce,omitempty"` ExecInst string `json:"execInst,omitempty"` ContingencyType string `json:"contingencyType,omitempty"` ExDestination string `json:"exDestination,omitempty"` OrdStatus string `json:"ordStatus,omitempty"` Triggered string `json:"triggered,omitempty"` WorkingIndicator bool `json:"workingIndicator,omitempty"` OrdRejReason string `json:"ordRejReason,omitempty"` SimpleLeavesQty float64 `json:"simpleLeavesQty,omitempty"` LeavesQty float32 `json:"leavesQty,omitempty"` SimpleCumQty float64 `json:"simpleCumQty,omitempty"` CumQty float32 `json:"cumQty,omitempty"` AvgPx float64 `json:"avgPx,omitempty"` MultiLegReportingType string `json:"multiLegReportingType,omitempty"` Text string `json:"text,omitempty"` TransactTime time.Time `json:"transactTime,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` }
Placement, Cancellation, Amending, and History
type OrderApiService ¶
type OrderApiService service
func (*OrderApiService) OrderAmend ¶
func (a *OrderApiService) OrderAmend(ctx context.Context, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
OrderApiService Amend the quantity or price of an open order.
Send an `orderID` or `origClOrdID` to identify the order you wish to amend. Both order quantity and price can be amended. Only one `qty` field can be used to amend. Use the `leavesQty` field to specify how much of the order you wish to remain open. This can be useful if you want to adjust your position's delta by a certain amount, regardless of how much of the order has already filled. Use the `simpleOrderQty` and `simpleLeavesQty` fields to specify order size in Bitcoin, rather than contracts. These fields will round up to the nearest contract. Like order placement, amending can be done in bulk. Simply send a request to `PUT /api/v1/order/bulk` with a JSON body of the shape: `{\"orders\": [{...}, {...}]}`, each object containing the fields used in this endpoint. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "orderID" (string) Order ID @param "origClOrdID" (string) Client Order ID. See POST /order. @param "clOrdID" (string) Optional new Client Order ID, requires `origClOrdID`. @param "simpleOrderQty" (float64) Optional order quantity in units of the underlying instrument (i.e. Bitcoin). @param "orderQty" (float32) Optional order quantity in units of the instrument (i.e. contracts). @param "simpleLeavesQty" (float64) Optional leaves quantity in units of the underlying instrument (i.e. Bitcoin). Useful for amending partially filled orders. @param "leavesQty" (float32) Optional leaves quantity in units of the instrument (i.e. contracts). Useful for amending partially filled orders. @param "price" (float64) Optional limit price for 'Limit', 'StopLimit', and 'LimitIfTouched' orders. @param "stopPx" (float64) Optional trigger price for 'Stop', 'StopLimit', 'MarketIfTouched', and 'LimitIfTouched' orders. Use a price below the current price for stop-sell orders and buy-if-touched orders. @param "pegOffsetValue" (float64) Optional trailing offset from the current price for 'Stop', 'StopLimit', 'MarketIfTouched', and 'LimitIfTouched' orders; use a negative offset for stop-sell orders and buy-if-touched orders. Optional offset from the peg price for 'Pegged' orders. @param "text" (string) Optional amend annotation. e.g. 'Adjust skew'.
@return Order
func (*OrderApiService) OrderAmendBulk ¶
func (a *OrderApiService) OrderAmendBulk(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
OrderApiService Amend multiple orders for the same symbol.
Similar to POST /amend, but with multiple orders. `application/json` only. Ratelimited at 50%. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "orders" (string) An array of orders.
@return []Order
func (*OrderApiService) OrderCancel ¶
func (a *OrderApiService) OrderCancel(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
OrderApiService Cancel order(s). Send multiple order IDs to cancel in bulk.
Either an orderID or a clOrdID must be provided. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "orderID" (string) Order ID(s). @param "clOrdID" (string) Client Order ID(s). See POST /order. @param "text" (string) Optional cancellation annotation. e.g. 'Spread Exceeded'.
@return []Order
func (*OrderApiService) OrderCancelAll ¶
func (a *OrderApiService) OrderCancelAll(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
OrderApiService Cancels all of your orders.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Optional symbol. If provided, only cancels orders for that symbol. @param "filter" (string) Optional filter for cancellation. Use to only cancel some orders, e.g. `{\"side\": \"Buy\"}`. @param "text" (string) Optional cancellation annotation. e.g. 'Spread Exceeded'
@return interface{}
func (*OrderApiService) OrderCancelAllAfter ¶
func (a *OrderApiService) OrderCancelAllAfter(ctx context.Context, timeout float64) (interface{}, *http.Response, error)
OrderApiService Automatically cancel all your orders after a specified timeout.
Useful as a dead-man's switch to ensure your orders are canceled in case of an outage. If called repeatedly, the existing offset will be canceled and a new one will be inserted in its place. Example usage: call this route at 15s intervals with an offset of 60000 (60s). If this route is not called within 60 seconds, all your orders will be automatically canceled. This is also available via [WebSocket](https://www.bitmex.com/app/wsAPI#dead-man-s-switch-auto-cancel-). * @param ctx context.Context Authentication Context @param timeout Timeout in ms. Set to 0 to cancel this timer. @return interface{}
func (*OrderApiService) OrderClosePosition ¶
func (a *OrderApiService) OrderClosePosition(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
OrderApiService Close a position. [Deprecated, use POST /order with execInst: 'Close']
If no `price` is specified, a market order will be submitted to close the whole of your position. This will also close all other open orders in this symbol. * @param ctx context.Context Authentication Context @param symbol Symbol of position to close. @param optional (nil or map[string]interface{}) with one or more of:
@param "price" (float64) Optional limit price.
@return Order
func (*OrderApiService) OrderGetOrders ¶
func (a *OrderApiService) OrderGetOrders(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
OrderApiService Get your orders.
To get open orders only, send {\"open\": true} in the filter param. See <a href=\"http://www.onixs.biz/fix-dictionary/5.0.SP2/msgType_D_68.html\">the FIX Spec</a> for explanations of these fields. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Order
func (*OrderApiService) OrderNew ¶
func (a *OrderApiService) OrderNew(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Order, *http.Response, error)
OrderApiService Create a new order.
## Placing Orders This endpoint is used for placing orders. See individual fields below for more details on their use. #### Order Types All orders require a `symbol`. All other fields are optional except when otherwise specified. These are the valid `ordType`s: * **Limit**: The default order type. Specify an `orderQty` and `price`. * **Market**: A traditional Market order. A Market order will execute until filled or your bankruptcy price is reached, at which point it will cancel. * **MarketWithLeftOverAsLimit**: A market order that, after eating through the order book as far as permitted by available margin, will become a limit order. The difference between this type and `Market` only affects the behavior in thin books. Upon reaching the deepest possible price, if there is quantity left over, a `Market` order will cancel the remaining quantity. `MarketWithLeftOverAsLimit` will keep the remaining quantity in the books as a `Limit`. * **Stop**: A Stop Market order. Specify an `orderQty` and `stopPx`. When the `stopPx` is reached, the order will be entered into the book. * On sell orders, the order will trigger if the triggering price is lower than the `stopPx`. On buys, higher. * Note: Stop orders do not consume margin until triggered. Be sure that the required margin is available in your account so that it may trigger fully. * `Close` Stops don't require an `orderQty`. See Execution Instructions below. * **StopLimit**: Like a Stop Market, but enters a Limit order instead of a Market order. Specify an `orderQty`, `stopPx`, and `price`. * **MarketIfTouched**: Similar to a Stop, but triggers are done in the opposite direction. Useful for Take Profit orders. * **LimitIfTouched**: As above; use for Take Profit Limit orders. #### Execution Instructions The following `execInst`s are supported. If using multiple, separate with a comma (e.g. `LastPrice,Close`). * **ParticipateDoNotInitiate**: Also known as a Post-Only order. If this order would have executed on placement, it will cancel instead. * **AllOrNone**: Valid only for hidden orders (`displayQty: 0`). Use to only execute if the entire order would fill. * **MarkPrice, LastPrice, IndexPrice**: Used by stop and if-touched orders to determine the triggering price. Use only one. By default, `'MarkPrice'` is used. Also used for Pegged orders to define the value of `'LastPeg'`. * **ReduceOnly**: A `'ReduceOnly'` order can only reduce your position, not increase it. If you have a `'ReduceOnly'` limit order that rests in the order book while the position is reduced by other orders, then its order quantity will be amended down or canceled. If there are multiple `'ReduceOnly'` orders the least agresssive will be amended first. * **Close**: `'Close'` implies `'ReduceOnly'`. A `'Close'` order will cancel other active limit orders with the same side and symbol if the open quantity exceeds the current position. This is useful for stops: by canceling these orders, a `'Close'` Stop is ensured to have the margin required to execute, and can only execute up to the full size of your position. If not specified, a `'Close'` order has an `orderQty` equal to your current position's size. #### Linked Orders Linked Orders are an advanced capability. It is very powerful, but its use requires careful coding and testing. Please follow this document carefully and use the [Testnet Exchange](https://testnet.bitmex.com) while developing. BitMEX offers four advanced Linked Order types: * **OCO**: *One Cancels the Other*. A very flexible version of the standard Stop / Take Profit technique. Multiple orders may be linked together using a single `clOrdLinkID`. Send a `contingencyType` of `OneCancelsTheOther` on the orders. The first order that fully or partially executes (or activates for `Stop` orders) will cancel all other orders with the same `clOrdLinkID`. * **OTO**: *One Triggers the Other*. Send a `contingencyType` of `'OneTriggersTheOther'` on the primary order and then subsequent orders with the same `clOrdLinkID` will be not be triggered until the primary order fully executes. * **OUOA**: *One Updates the Other Absolute*. Send a `contingencyType` of `'OneUpdatesTheOtherAbsolute'` on the orders. Then as one order has a execution, other orders with the same `clOrdLinkID` will have their order quantity amended down by the execution quantity. * **OUOP**: *One Updates the Other Proportional*. Send a `contingencyType` of `'OneUpdatesTheOtherProportional'` on the orders. Then as one order has a execution, other orders with the same `clOrdLinkID` will have their order quantity reduced proportionally by the fill percentage. #### Trailing Stops You may use `pegPriceType` of `'TrailingStopPeg'` to create Trailing Stops. The pegged `stopPx` will move as the market moves away from the peg, and freeze as the market moves toward it. To use, combine with `pegOffsetValue` to set the `stopPx` of your order. The peg is set to the triggering price specified in the `execInst` (default `'MarkPrice'`). Use a negative offset for stop-sell and buy-if-touched orders. Requires `ordType`: `'Stop', 'StopLimit', 'MarketIfTouched', 'LimitIfTouched'`. #### Simple Quantities Send a `simpleOrderQty` instead of an `orderQty` to create an order denominated in the underlying currency. This is useful for opening up a position with 1 XBT of exposure without having to calculate how many contracts it is. #### Rate Limits See the [Bulk Order Documentation](#!/Order/Order_newBulk) if you need to place multiple orders at the same time. Bulk orders require fewer risk checks in the trading engine and thus are ratelimited at **1/10** the normal rate. You can also improve your reactivity to market movements while staying under your ratelimit by using the [Amend](#!/Order/Order_amend) and [Amend Bulk](#!/Order/Order_amendBulk) endpoints. This allows you to stay in the market and avoids the cancel/replace cycle. #### Tracking Your Orders If you want to keep track of order IDs yourself, set a unique `clOrdID` per order. This `clOrdID` will come back as a property on the order and any related executions (including on the WebSocket), and can be used to get or cancel the order. Max length is 36 characters. * @param ctx context.Context Authentication Context @param symbol Instrument symbol. e.g. 'XBTUSD'. @param optional (nil or map[string]interface{}) with one or more of:
@param "side" (string) Order side. Valid options: Buy, Sell. Defaults to 'Buy' unless `orderQty` or `simpleOrderQty` is negative. @param "simpleOrderQty" (float64) Order quantity in units of the underlying instrument (i.e. Bitcoin). @param "quantity" (float32) Deprecated: use `orderQty`. @param "orderQty" (float32) Order quantity in units of the instrument (i.e. contracts). @param "price" (float64) Optional limit price for 'Limit', 'StopLimit', and 'LimitIfTouched' orders. @param "displayQty" (float32) Optional quantity to display in the book. Use 0 for a fully hidden order. @param "stopPrice" (float64) Deprecated: use `stopPx`. @param "stopPx" (float64) Optional trigger price for 'Stop', 'StopLimit', 'MarketIfTouched', and 'LimitIfTouched' orders. Use a price below the current price for stop-sell orders and buy-if-touched orders. Use `execInst` of 'MarkPrice' or 'LastPrice' to define the current price used for triggering. @param "clOrdID" (string) Optional Client Order ID. This clOrdID will come back on the order and any related executions. @param "clOrdLinkID" (string) Optional Client Order Link ID for contingent orders. @param "pegOffsetValue" (float64) Optional trailing offset from the current price for 'Stop', 'StopLimit', 'MarketIfTouched', and 'LimitIfTouched' orders; use a negative offset for stop-sell orders and buy-if-touched orders. Optional offset from the peg price for 'Pegged' orders. @param "pegPriceType" (string) Optional peg price type. Valid options: LastPeg, MidPricePeg, MarketPeg, PrimaryPeg, TrailingStopPeg. @param "type_" (string) Deprecated: use `ordType`. @param "ordType" (string) Order type. Valid options: Market, Limit, Stop, StopLimit, MarketIfTouched, LimitIfTouched, MarketWithLeftOverAsLimit, Pegged. Defaults to 'Limit' when `price` is specified. Defaults to 'Stop' when `stopPx` is specified. Defaults to 'StopLimit' when `price` and `stopPx` are specified. @param "timeInForce" (string) Time in force. Valid options: Day, GoodTillCancel, ImmediateOrCancel, FillOrKill. Defaults to 'GoodTillCancel' for 'Limit', 'StopLimit', 'LimitIfTouched', and 'MarketWithLeftOverAsLimit' orders. @param "execInst" (string) Optional execution instructions. Valid options: ParticipateDoNotInitiate, AllOrNone, MarkPrice, IndexPrice, LastPrice, Close, ReduceOnly, Fixed. 'AllOrNone' instruction requires `displayQty` to be 0. 'MarkPrice', 'IndexPrice' or 'LastPrice' instruction valid for 'Stop', 'StopLimit', 'MarketIfTouched', and 'LimitIfTouched' orders. @param "contingencyType" (string) Optional contingency type for use with `clOrdLinkID`. Valid options: OneCancelsTheOther, OneTriggersTheOther, OneUpdatesTheOtherAbsolute, OneUpdatesTheOtherProportional. @param "text" (string) Optional order annotation. e.g. 'Take profit'.
@return Order
func (*OrderApiService) OrderNewBulk ¶
func (a *OrderApiService) OrderNewBulk(ctx context.Context, localVarOptionals map[string]interface{}) ([]Order, *http.Response, error)
OrderApiService Create multiple new orders for the same symbol.
This endpoint is used for placing bulk orders. Valid order types are Market, Limit, Stop, StopLimit, MarketIfTouched, LimitIfTouched, MarketWithLeftOverAsLimit, and Pegged. Each individual order object in the array should have the same properties as an individual POST /order call. This endpoint is much faster for getting many orders into the book at once. Because it reduces load on BitMEX systems, this endpoint is ratelimited at `ceil(0.1 * orders)`. Submitting 10 orders via a bulk order call will only count as 1 request, 15 as 2, 32 as 4, and so on. For now, only `application/json` is supported on this endpoint. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "orders" (string) An array of orders.
@return []Order
type OrderBook ¶
type OrderBook struct { Symbol string `json:"symbol"` Level float32 `json:"level"` BidSize float32 `json:"bidSize,omitempty"` BidPrice float64 `json:"bidPrice,omitempty"` AskPrice float64 `json:"askPrice,omitempty"` AskSize float32 `json:"askSize,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` }
Level 2 Book Data
type OrderBookApiService ¶
type OrderBookApiService service
func (*OrderBookApiService) OrderBookGet ¶
func (a *OrderBookApiService) OrderBookGet(symbol string, localVarOptionals map[string]interface{}) ([]OrderBook, *http.Response, error)
OrderBookApiService Get current orderbook [deprecated, use /orderBook/L2].
@param symbol Instrument symbol. Send a series (e.g. XBT) to get data for the nearest contract in that series. @param optional (nil or map[string]interface{}) with one or more of:
@param "depth" (float32) Orderbook depth.
@return []OrderBook
func (*OrderBookApiService) OrderBookGetL2 ¶
func (a *OrderBookApiService) OrderBookGetL2(symbol string, localVarOptionals map[string]interface{}) ([]OrderBookL2, *http.Response, error)
OrderBookApiService Get current orderbook in vertical format.
@param symbol Instrument symbol. Send a series (e.g. XBT) to get data for the nearest contract in that series. @param optional (nil or map[string]interface{}) with one or more of:
@param "depth" (float32) Orderbook depth per side. Send 0 for full depth.
@return []OrderBookL2
type OrderBookL2 ¶
type Position ¶
type Position struct { Account float32 `json:"account"` Symbol string `json:"symbol"` Currency string `json:"currency"` Underlying string `json:"underlying,omitempty"` QuoteCurrency string `json:"quoteCurrency,omitempty"` Commission float64 `json:"commission,omitempty"` InitMarginReq float64 `json:"initMarginReq,omitempty"` MaintMarginReq float64 `json:"maintMarginReq,omitempty"` RiskLimit float32 `json:"riskLimit,omitempty"` Leverage float64 `json:"leverage,omitempty"` CrossMargin bool `json:"crossMargin,omitempty"` DeleveragePercentile float64 `json:"deleveragePercentile,omitempty"` RebalancedPnl float32 `json:"rebalancedPnl,omitempty"` PrevRealisedPnl float32 `json:"prevRealisedPnl,omitempty"` PrevUnrealisedPnl float32 `json:"prevUnrealisedPnl,omitempty"` PrevClosePrice float64 `json:"prevClosePrice,omitempty"` OpeningTimestamp time.Time `json:"openingTimestamp,omitempty"` OpeningQty float32 `json:"openingQty,omitempty"` OpeningCost float32 `json:"openingCost,omitempty"` OpeningComm float32 `json:"openingComm,omitempty"` OpenOrderBuyQty float32 `json:"openOrderBuyQty,omitempty"` OpenOrderBuyCost float32 `json:"openOrderBuyCost,omitempty"` OpenOrderBuyPremium float32 `json:"openOrderBuyPremium,omitempty"` OpenOrderSellQty float32 `json:"openOrderSellQty,omitempty"` OpenOrderSellCost float32 `json:"openOrderSellCost,omitempty"` OpenOrderSellPremium float32 `json:"openOrderSellPremium,omitempty"` ExecBuyQty float32 `json:"execBuyQty,omitempty"` ExecBuyCost float32 `json:"execBuyCost,omitempty"` ExecSellQty float32 `json:"execSellQty,omitempty"` ExecSellCost float32 `json:"execSellCost,omitempty"` ExecQty float32 `json:"execQty,omitempty"` ExecCost float32 `json:"execCost,omitempty"` ExecComm float32 `json:"execComm,omitempty"` CurrentTimestamp time.Time `json:"currentTimestamp,omitempty"` CurrentQty float32 `json:"currentQty,omitempty"` CurrentCost float32 `json:"currentCost,omitempty"` CurrentComm float32 `json:"currentComm,omitempty"` RealisedCost float32 `json:"realisedCost,omitempty"` UnrealisedCost float32 `json:"unrealisedCost,omitempty"` GrossOpenCost float32 `json:"grossOpenCost,omitempty"` GrossOpenPremium float32 `json:"grossOpenPremium,omitempty"` GrossExecCost float32 `json:"grossExecCost,omitempty"` IsOpen bool `json:"isOpen,omitempty"` MarkPrice float64 `json:"markPrice,omitempty"` MarkValue float32 `json:"markValue,omitempty"` RiskValue float32 `json:"riskValue,omitempty"` HomeNotional float64 `json:"homeNotional,omitempty"` ForeignNotional float64 `json:"foreignNotional,omitempty"` PosState string `json:"posState,omitempty"` PosCost float32 `json:"posCost,omitempty"` PosCost2 float32 `json:"posCost2,omitempty"` PosCross float32 `json:"posCross,omitempty"` PosInit float32 `json:"posInit,omitempty"` PosComm float32 `json:"posComm,omitempty"` PosLoss float32 `json:"posLoss,omitempty"` PosMargin float32 `json:"posMargin,omitempty"` PosMaint float32 `json:"posMaint,omitempty"` PosAllowance float32 `json:"posAllowance,omitempty"` TaxableMargin float32 `json:"taxableMargin,omitempty"` InitMargin float32 `json:"initMargin,omitempty"` MaintMargin float32 `json:"maintMargin,omitempty"` SessionMargin float32 `json:"sessionMargin,omitempty"` TargetExcessMargin float32 `json:"targetExcessMargin,omitempty"` VarMargin float32 `json:"varMargin,omitempty"` RealisedGrossPnl float32 `json:"realisedGrossPnl,omitempty"` RealisedTax float32 `json:"realisedTax,omitempty"` RealisedPnl float32 `json:"realisedPnl,omitempty"` UnrealisedGrossPnl float32 `json:"unrealisedGrossPnl,omitempty"` LongBankrupt float32 `json:"longBankrupt,omitempty"` ShortBankrupt float32 `json:"shortBankrupt,omitempty"` TaxBase float32 `json:"taxBase,omitempty"` IndicativeTaxRate float64 `json:"indicativeTaxRate,omitempty"` IndicativeTax float32 `json:"indicativeTax,omitempty"` UnrealisedTax float32 `json:"unrealisedTax,omitempty"` UnrealisedPnl float32 `json:"unrealisedPnl,omitempty"` UnrealisedPnlPcnt float64 `json:"unrealisedPnlPcnt,omitempty"` UnrealisedRoePcnt float64 `json:"unrealisedRoePcnt,omitempty"` SimpleQty float64 `json:"simpleQty,omitempty"` SimpleCost float64 `json:"simpleCost,omitempty"` SimpleValue float64 `json:"simpleValue,omitempty"` SimplePnl float64 `json:"simplePnl,omitempty"` SimplePnlPcnt float64 `json:"simplePnlPcnt,omitempty"` AvgCostPrice float64 `json:"avgCostPrice,omitempty"` AvgEntryPrice float64 `json:"avgEntryPrice,omitempty"` BreakEvenPrice float64 `json:"breakEvenPrice,omitempty"` MarginCallPrice float64 `json:"marginCallPrice,omitempty"` LiquidationPrice float64 `json:"liquidationPrice,omitempty"` BankruptPrice float64 `json:"bankruptPrice,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` LastPrice float64 `json:"lastPrice,omitempty"` LastValue float32 `json:"lastValue,omitempty"` }
Summary of Open and Closed Positions
type PositionApiService ¶
type PositionApiService service
func (*PositionApiService) PositionGet ¶
func (a *PositionApiService) PositionGet(ctx context.Context, localVarOptionals map[string]interface{}) ([]Position, *http.Response, error)
PositionApiService Get your positions.
See <a href=\"http://www.onixs.biz/fix-dictionary/5.0.SP2/msgType_AP_6580.html\">the FIX Spec</a> for explanations of these fields. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "filter" (string) Table filter. For example, send {\"symbol\": \"XBTUSD\"}. @param "columns" (string) Which columns to fetch. For example, send [\"columnName\"]. @param "count" (float32) Number of rows to fetch.
@return []Position
func (*PositionApiService) PositionIsolateMargin ¶
func (a *PositionApiService) PositionIsolateMargin(ctx context.Context, symbol string, localVarOptionals map[string]interface{}) (Position, *http.Response, error)
PositionApiService Enable isolated margin or cross margin per-position.
Users can switch isolate margin per-position. This function allows switching margin isolation (aka fixed margin) on and off. * @param ctx context.Context Authentication Context @param symbol Position symbol to isolate. @param optional (nil or map[string]interface{}) with one or more of:
@param "enabled" (bool) True for isolated margin, false for cross margin.
@return Position
func (*PositionApiService) PositionTransferIsolatedMargin ¶
func (a *PositionApiService) PositionTransferIsolatedMargin(ctx context.Context, symbol string, amount float32) (Position, *http.Response, error)
PositionApiService Transfer equity in or out of a position.
When margin is isolated on a position, use this function to add or remove margin from the position. Note that you cannot remove margin below the initial margin threshold. * @param ctx context.Context Authentication Context @param symbol Symbol of position to isolate. @param amount Amount to transfer, in Satoshis. May be negative. @return Position
func (*PositionApiService) PositionUpdateLeverage ¶
func (a *PositionApiService) PositionUpdateLeverage(ctx context.Context, symbol string, leverage float64) (Position, *http.Response, error)
PositionApiService Choose leverage for a position.
Users can choose an isolated leverage. This will automatically enable isolated margin. * @param ctx context.Context Authentication Context @param symbol Symbol of position to adjust. @param leverage Leverage value. Send a number between 0.01 and 100 to enable isolated margin with a fixed leverage. Send 0 to enable cross margin. @return Position
func (*PositionApiService) PositionUpdateRiskLimit ¶
func (a *PositionApiService) PositionUpdateRiskLimit(ctx context.Context, symbol string, riskLimit float32) (Position, *http.Response, error)
PositionApiService Update your risk limit.
Risk Limits limit the size of positions you can trade at various margin levels. Larger positions require more margin. Please see the Risk Limit documentation for more details. * @param ctx context.Context Authentication Context @param symbol Symbol of position to isolate. @param riskLimit New Risk Limit, in Satoshis. @return Position
type Quote ¶
type Quote struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol"` BidSize float32 `json:"bidSize,omitempty"` BidPrice float64 `json:"bidPrice,omitempty"` AskPrice float64 `json:"askPrice,omitempty"` AskSize float32 `json:"askSize,omitempty"` }
Best Bid/Offer Snapshots & Historical Bins
type QuoteApiService ¶
type QuoteApiService service
func (*QuoteApiService) QuoteGet ¶
func (a *QuoteApiService) QuoteGet(localVarOptionals map[string]interface{}) ([]Quote, *http.Response, error)
QuoteApiService Get Quotes.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Quote
func (*QuoteApiService) QuoteGetBucketed ¶
func (a *QuoteApiService) QuoteGetBucketed(localVarOptionals map[string]interface{}) ([]Quote, *http.Response, error)
QuoteApiService Get previous quotes in time buckets.
@param optional (nil or map[string]interface{}) with one or more of:
@param "binSize" (string) Time interval to bucket by. Available options: [1m,5m,1h,1d]. @param "partial" (bool) If true, will send in-progress (incomplete) bins for the current time period. @param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Quote
type SchemaApiService ¶
type SchemaApiService service
func (*SchemaApiService) SchemaGet ¶
func (a *SchemaApiService) SchemaGet(localVarOptionals map[string]interface{}) (interface{}, *http.Response, error)
SchemaApiService Get model schemata for data objects returned by this API.
@param optional (nil or map[string]interface{}) with one or more of:
@param "model" (string) Optional model filter. If omitted, will return all models.
@return interface{}
func (*SchemaApiService) SchemaWebsocketHelp ¶
func (a *SchemaApiService) SchemaWebsocketHelp() (interface{}, *http.Response, error)
SchemaApiService Returns help text & subject list for websocket usage.
@return interface{}
type Settlement ¶
type Settlement struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol"` SettlementType string `json:"settlementType,omitempty"` SettledPrice float64 `json:"settledPrice,omitempty"` Bankrupt float32 `json:"bankrupt,omitempty"` TaxBase float32 `json:"taxBase,omitempty"` TaxRate float64 `json:"taxRate,omitempty"` }
Historical Settlement Data
type SettlementApiService ¶
type SettlementApiService service
func (*SettlementApiService) SettlementGet ¶
func (a *SettlementApiService) SettlementGet(localVarOptionals map[string]interface{}) ([]Settlement, *http.Response, error)
SettlementApiService Get settlement history.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Settlement
type Stats ¶
type Stats struct { RootSymbol string `json:"rootSymbol"` Currency string `json:"currency,omitempty"` Volume24h float32 `json:"volume24h,omitempty"` Turnover24h float32 `json:"turnover24h,omitempty"` OpenInterest float32 `json:"openInterest,omitempty"` OpenValue float32 `json:"openValue,omitempty"` }
Exchange Statistics
type StatsApiService ¶
type StatsApiService service
func (*StatsApiService) StatsGet ¶
func (a *StatsApiService) StatsGet() ([]Stats, *http.Response, error)
StatsApiService Get exchange-wide and per-series turnover and volume statistics.
@return []Stats
func (*StatsApiService) StatsHistory ¶
func (a *StatsApiService) StatsHistory() ([]StatsHistory, *http.Response, error)
StatsApiService Get historical exchange-wide and per-series turnover and volume statistics.
@return []StatsHistory
func (*StatsApiService) StatsHistoryUSD ¶
func (a *StatsApiService) StatsHistoryUSD() ([]StatsUsd, *http.Response, error)
StatsApiService Get a summary of exchange statistics in USD.
@return []StatsUsd
type StatsHistory ¶
type StatsUsd ¶
type StatsUsd struct { RootSymbol string `json:"rootSymbol"` Currency string `json:"currency,omitempty"` Turnover24h float32 `json:"turnover24h,omitempty"` Turnover30d float32 `json:"turnover30d,omitempty"` Turnover365d float32 `json:"turnover365d,omitempty"` Turnover float32 `json:"turnover,omitempty"` }
type Trade ¶
type Trade struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol"` Side string `json:"side,omitempty"` Size float32 `json:"size,omitempty"` Price float64 `json:"price,omitempty"` TickDirection string `json:"tickDirection,omitempty"` TrdMatchID string `json:"trdMatchID,omitempty"` GrossValue float32 `json:"grossValue,omitempty"` HomeNotional float64 `json:"homeNotional,omitempty"` ForeignNotional float64 `json:"foreignNotional,omitempty"` }
Individual & Bucketed Trades
type TradeApiService ¶
type TradeApiService service
func (*TradeApiService) TradeGet ¶
func (a *TradeApiService) TradeGet(localVarOptionals map[string]interface{}) ([]Trade, *http.Response, error)
TradeApiService Get Trades.
Please note that indices (symbols starting with `.`) post trades at intervals to the trade feed. These have a `size` of 0 and are used only to indicate a changing price. See [the FIX Spec](http://www.onixs.biz/fix-dictionary/5.0.SP2/msgType_AE_6569.html) for explanations of these fields.
@param optional (nil or map[string]interface{}) with one or more of:
@param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []Trade
func (*TradeApiService) TradeGetBucketed ¶
func (a *TradeApiService) TradeGetBucketed(localVarOptionals map[string]interface{}) ([]TradeBin, *http.Response, error)
TradeApiService Get previous trades in time buckets.
@param optional (nil or map[string]interface{}) with one or more of:
@param "binSize" (string) Time interval to bucket by. Available options: [1m,5m,1h,1d]. @param "partial" (bool) If true, will send in-progress (incomplete) bins for the current time period. @param "symbol" (string) Instrument symbol. Send a bare series (e.g. XBU) to get data for the nearest expiring contract in that series. You can also send a timeframe, e.g. `XBU:monthly`. Timeframes are `daily`, `weekly`, `monthly`, `quarterly`, and `biquarterly`. @param "filter" (string) Generic table filter. Send JSON key/value pairs, such as `{\"key\": \"value\"}`. You can key on individual fields, and do more advanced querying on timestamps. See the [Timestamp Docs](https://www.bitmex.com/app/restAPI#timestamp-filters) for more details. @param "columns" (string) Array of column names to fetch. If omitted, will return all columns. Note that this method will always return item keys, even when not specified, so you may receive more columns that you expect. @param "count" (float32) Number of results to fetch. @param "start" (float32) Starting point for results. @param "reverse" (bool) If true, will sort results newest first. @param "startTime" (time.Time) Starting date filter for results. @param "endTime" (time.Time) Ending date filter for results.
@return []TradeBin
type TradeBin ¶
type TradeBin struct { Timestamp time.Time `json:"timestamp"` Symbol string `json:"symbol"` Open float64 `json:"open,omitempty"` High float64 `json:"high,omitempty"` Low float64 `json:"low,omitempty"` Close float64 `json:"close,omitempty"` Trades float32 `json:"trades,omitempty"` Volume float32 `json:"volume,omitempty"` Vwap float64 `json:"vwap,omitempty"` LastSize float32 `json:"lastSize,omitempty"` Turnover float32 `json:"turnover,omitempty"` HomeNotional float64 `json:"homeNotional,omitempty"` ForeignNotional float64 `json:"foreignNotional,omitempty"` }
type Transaction ¶
type Transaction struct { TransactID string `json:"transactID"` Account float32 `json:"account,omitempty"` Currency string `json:"currency,omitempty"` TransactType string `json:"transactType,omitempty"` Amount float32 `json:"amount,omitempty"` Fee float32 `json:"fee,omitempty"` TransactStatus string `json:"transactStatus,omitempty"` Address string `json:"address,omitempty"` Tx string `json:"tx,omitempty"` Text string `json:"text,omitempty"` TransactTime time.Time `json:"transactTime,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` }
type User ¶
type User struct { Id float32 `json:"id,omitempty"` OwnerId float32 `json:"ownerId,omitempty"` Firstname string `json:"firstname,omitempty"` Lastname string `json:"lastname,omitempty"` Username string `json:"username"` Email string `json:"email"` Phone string `json:"phone,omitempty"` Created time.Time `json:"created,omitempty"` LastUpdated time.Time `json:"lastUpdated,omitempty"` Preferences *UserPreferences `json:"preferences,omitempty"` TFAEnabled string `json:"TFAEnabled,omitempty"` AffiliateID string `json:"affiliateID,omitempty"` PgpPubKey string `json:"pgpPubKey,omitempty"` Country string `json:"country,omitempty"` }
Account Operations
type UserApiService ¶
type UserApiService service
func (*UserApiService) UserCancelWithdrawal ¶
func (a *UserApiService) UserCancelWithdrawal(token string) (Transaction, *http.Response, error)
UserApiService Cancel a withdrawal.
@param token @return Transaction
func (*UserApiService) UserCheckReferralCode ¶
func (a *UserApiService) UserCheckReferralCode(localVarOptionals map[string]interface{}) (float64, *http.Response, error)
UserApiService Check if a referral code is valid.
If the code is valid, responds with the referral code's discount (e.g. `0.1` for 10%). Otherwise, will return a 404.
@param optional (nil or map[string]interface{}) with one or more of:
@param "referralCode" (string)
@return float64
func (*UserApiService) UserConfirm ¶
func (a *UserApiService) UserConfirm(token string) (AccessToken, *http.Response, error)
UserApiService Confirm your email address with a token.
@param token @return AccessToken
func (*UserApiService) UserConfirmEnableTFA ¶
func (a *UserApiService) UserConfirmEnableTFA(ctx context.Context, token string, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
UserApiService Confirm two-factor auth for this account. If using a Yubikey, simply send a token to this endpoint.
* @param ctx context.Context Authentication Context @param token Token from your selected TFA type. @param optional (nil or map[string]interface{}) with one or more of:
@param "type_" (string) Two-factor auth type. Supported types: 'GA' (Google Authenticator), 'Yubikey'
@return bool
func (*UserApiService) UserConfirmWithdrawal ¶
func (a *UserApiService) UserConfirmWithdrawal(token string) (Transaction, *http.Response, error)
UserApiService Confirm a withdrawal.
@param token @return Transaction
func (*UserApiService) UserDisableTFA ¶
func (a *UserApiService) UserDisableTFA(ctx context.Context, token string, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
UserApiService Disable two-factor auth for this account.
* @param ctx context.Context Authentication Context @param token Token from your selected TFA type. @param optional (nil or map[string]interface{}) with one or more of:
@param "type_" (string) Two-factor auth type. Supported types: 'GA' (Google Authenticator)
@return bool
func (*UserApiService) UserGet ¶
UserApiService Get your user model. * @param ctx context.Context Authentication Context @return User
func (*UserApiService) UserGetAffiliateStatus ¶
func (a *UserApiService) UserGetAffiliateStatus(ctx context.Context) (Affiliate, *http.Response, error)
UserApiService Get your current affiliate/referral status. * @param ctx context.Context Authentication Context @return Affiliate
func (*UserApiService) UserGetCommission ¶
func (a *UserApiService) UserGetCommission(ctx context.Context) ([]UserCommission, *http.Response, error)
UserApiService Get your account's commission status. * @param ctx context.Context Authentication Context @return []UserCommission
func (*UserApiService) UserGetDepositAddress ¶
func (a *UserApiService) UserGetDepositAddress(ctx context.Context, localVarOptionals map[string]interface{}) (string, *http.Response, error)
UserApiService Get a deposit address.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return string
func (*UserApiService) UserGetMargin ¶
func (a *UserApiService) UserGetMargin(ctx context.Context, localVarOptionals map[string]interface{}) (Margin, *http.Response, error)
UserApiService Get your account's margin status. Send a currency of \"all\" to receive an array of all supported currencies.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return Margin
func (*UserApiService) UserGetWallet ¶
func (a *UserApiService) UserGetWallet(ctx context.Context, localVarOptionals map[string]interface{}) (Wallet, *http.Response, error)
UserApiService Get your current wallet information.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return Wallet
func (*UserApiService) UserGetWalletHistory ¶
func (a *UserApiService) UserGetWalletHistory(ctx context.Context, localVarOptionals map[string]interface{}) ([]Transaction, *http.Response, error)
UserApiService Get a history of all of your wallet transactions (deposits, withdrawals, PNL).
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return []Transaction
func (*UserApiService) UserGetWalletSummary ¶
func (a *UserApiService) UserGetWalletSummary(ctx context.Context, localVarOptionals map[string]interface{}) ([]Transaction, *http.Response, error)
UserApiService Get a summary of all of your wallet transactions (deposits, withdrawals, PNL).
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return []Transaction
func (*UserApiService) UserLogout ¶
func (a *UserApiService) UserLogout() (*http.Response, error)
UserApiService Log out of BitMEX.
@return
func (*UserApiService) UserLogoutAll ¶
UserApiService Log all systems out of BitMEX. This will revoke all of your account's access tokens, logging you out on all devices. * @param ctx context.Context Authentication Context @return float64
func (*UserApiService) UserMinWithdrawalFee ¶
func (a *UserApiService) UserMinWithdrawalFee(localVarOptionals map[string]interface{}) (interface{}, *http.Response, error)
UserApiService Get the minimum withdrawal fee for a currency.
This is changed based on network conditions to ensure timely withdrawals. During network congestion, this may be high. The fee is returned in the same currency.
@param optional (nil or map[string]interface{}) with one or more of:
@param "currency" (string)
@return interface{}
func (*UserApiService) UserRequestEnableTFA ¶
func (a *UserApiService) UserRequestEnableTFA(ctx context.Context, localVarOptionals map[string]interface{}) (bool, *http.Response, error)
UserApiService Get secret key for setting up two-factor auth.
Use /confirmEnableTFA directly for Yubikeys. This fails if TFA is already enabled. * @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "type_" (string) Two-factor auth type. Supported types: 'GA' (Google Authenticator)
@return bool
func (*UserApiService) UserRequestWithdrawal ¶
func (a *UserApiService) UserRequestWithdrawal(ctx context.Context, currency string, amount float32, address string, localVarOptionals map[string]interface{}) (Transaction, *http.Response, error)
UserApiService Request a withdrawal to an external wallet.
This will send a confirmation email to the email address on record, unless requested via an API Key with the `withdraw` permission. * @param ctx context.Context Authentication Context @param currency Currency you're withdrawing. Options: `XBt` @param amount Amount of withdrawal currency. @param address Destination Address. @param optional (nil or map[string]interface{}) with one or more of:
@param "otpToken" (string) 2FA token. Required if 2FA is enabled on your account. @param "fee" (float64) Network fee for Bitcoin withdrawals. If not specified, a default value will be calculated based on Bitcoin network conditions. You will have a chance to confirm this via email.
@return Transaction
func (*UserApiService) UserSavePreferences ¶
func (a *UserApiService) UserSavePreferences(ctx context.Context, prefs string, localVarOptionals map[string]interface{}) (User, *http.Response, error)
UserApiService Save user preferences.
* @param ctx context.Context Authentication Context @param prefs @param optional (nil or map[string]interface{}) with one or more of:
@param "overwrite" (bool) If true, will overwrite all existing preferences.
@return User
func (*UserApiService) UserUpdate ¶
func (a *UserApiService) UserUpdate(ctx context.Context, localVarOptionals map[string]interface{}) (User, *http.Response, error)
UserApiService Update your password, name, and other attributes.
* @param ctx context.Context Authentication Context @param optional (nil or map[string]interface{}) with one or more of:
@param "firstname" (string) @param "lastname" (string) @param "oldPassword" (string) @param "newPassword" (string) @param "newPasswordConfirm" (string) @param "username" (string) Username can only be set once. To reset, email support. @param "country" (string) Country of residence. @param "pgpPubKey" (string) PGP Public Key. If specified, automated emails will be sentwith this key.
@return User
type UserCommission ¶
type UserPreferences ¶
type UserPreferences struct { AlertOnLiquidations bool `json:"alertOnLiquidations,omitempty"` AnimationsEnabled bool `json:"animationsEnabled,omitempty"` AnnouncementsLastSeen time.Time `json:"announcementsLastSeen,omitempty"` ChatChannelID float64 `json:"chatChannelID,omitempty"` ColorTheme string `json:"colorTheme,omitempty"` Currency string `json:"currency,omitempty"` Debug bool `json:"debug,omitempty"` DisableEmails []string `json:"disableEmails,omitempty"` HideConfirmDialogs []string `json:"hideConfirmDialogs,omitempty"` HideConnectionModal bool `json:"hideConnectionModal,omitempty"` HideFromLeaderboard bool `json:"hideFromLeaderboard,omitempty"` HideNameFromLeaderboard bool `json:"hideNameFromLeaderboard,omitempty"` HideNotifications []string `json:"hideNotifications,omitempty"` Locale string `json:"locale,omitempty"` MsgsSeen []string `json:"msgsSeen,omitempty"` OrderBookBinning *interface{} `json:"orderBookBinning,omitempty"` OrderBookType string `json:"orderBookType,omitempty"` OrderClearImmediate bool `json:"orderClearImmediate,omitempty"` OrderControlsPlusMinus bool `json:"orderControlsPlusMinus,omitempty"` Sounds []string `json:"sounds,omitempty"` StrictIPCheck bool `json:"strictIPCheck,omitempty"` StrictTimeout bool `json:"strictTimeout,omitempty"` TickerGroup string `json:"tickerGroup,omitempty"` TickerPinned bool `json:"tickerPinned,omitempty"` TradeLayout string `json:"tradeLayout,omitempty"` }
type Wallet ¶
type Wallet struct { Account float32 `json:"account"` Currency string `json:"currency"` PrevDeposited float32 `json:"prevDeposited,omitempty"` PrevWithdrawn float32 `json:"prevWithdrawn,omitempty"` PrevTransferIn float32 `json:"prevTransferIn,omitempty"` PrevTransferOut float32 `json:"prevTransferOut,omitempty"` PrevAmount float32 `json:"prevAmount,omitempty"` PrevTimestamp time.Time `json:"prevTimestamp,omitempty"` DeltaDeposited float32 `json:"deltaDeposited,omitempty"` DeltaWithdrawn float32 `json:"deltaWithdrawn,omitempty"` DeltaTransferIn float32 `json:"deltaTransferIn,omitempty"` DeltaTransferOut float32 `json:"deltaTransferOut,omitempty"` DeltaAmount float32 `json:"deltaAmount,omitempty"` Deposited float32 `json:"deposited,omitempty"` Withdrawn float32 `json:"withdrawn,omitempty"` TransferIn float32 `json:"transferIn,omitempty"` TransferOut float32 `json:"transferOut,omitempty"` Amount float32 `json:"amount,omitempty"` PendingCredit float32 `json:"pendingCredit,omitempty"` PendingDebit float32 `json:"pendingDebit,omitempty"` ConfirmedDebit float32 `json:"confirmedDebit,omitempty"` Timestamp time.Time `json:"timestamp,omitempty"` Addr string `json:"addr,omitempty"` Script string `json:"script,omitempty"` WithdrawalLock []string `json:"withdrawalLock,omitempty"` }
Source Files ¶
- access_token.go
- affiliate.go
- announcement.go
- announcement_api.go
- api_client.go
- api_key.go
- api_key_api.go
- api_response.go
- auth_util.go
- chat.go
- chat_api.go
- chat_channel.go
- configuration.go
- connected_users.go
- error_error.go
- execution.go
- execution_api.go
- funding.go
- funding_api.go
- index_composite.go
- inline_response_200.go
- instrument.go
- instrument_api.go
- instrument_interval.go
- insurance.go
- insurance_api.go
- leaderboard.go
- leaderboard_api.go
- liquidation.go
- liquidation_api.go
- margin.go
- model_error.go
- notification.go
- notification_api.go
- order.go
- order_api.go
- order_book.go
- order_book_api.go
- order_book_l2.go
- position.go
- position_api.go
- quote.go
- quote_api.go
- schema_api.go
- settlement.go
- settlement_api.go
- stats.go
- stats_api.go
- stats_history.go
- stats_usd.go
- trade.go
- trade_api.go
- trade_bin.go
- transaction.go
- user.go
- user_api.go
- user_commission.go
- user_preferences.go
- wallet.go
- x_any.go