Skip to content

Latest commit

 

History

History
 
 

java

README.md

swagger-java-client

Requirements

Building the API client library requires Maven to be installed.

Installation

To install the API client library to your local Maven repository, simply execute:

mvn install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn deploy

Refer to the official documentation for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-java-client</artifactId>
    <version>1.0.0</version>
    <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile "io.swagger:swagger-java-client:1.0.0"

Others

At first generate the JAR by executing:

mvn package

Then manually install the following JARs:

  • target/swagger-java-client-1.0.0.jar
  • target/lib/*.jar

Getting Started

Please follow the installation instruction and execute the following Java code:

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.APIKeyApi;

import java.io.File;
import java.util.*;

public class APIKeyApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apiKey
        ApiKeyAuth apiKey = (ApiKeyAuth) defaultClient.getAuthentication("apiKey");
        apiKey.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apiKey.setApiKeyPrefix("Token");

        // Configure API key authorization: apiNonce
        ApiKeyAuth apiNonce = (ApiKeyAuth) defaultClient.getAuthentication("apiNonce");
        apiNonce.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apiNonce.setApiKeyPrefix("Token");

        // Configure API key authorization: apiSignature
        ApiKeyAuth apiSignature = (ApiKeyAuth) defaultClient.getAuthentication("apiSignature");
        apiSignature.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apiSignature.setApiKeyPrefix("Token");

        APIKeyApi apiInstance = new APIKeyApi();
        String apiKeyID = "apiKeyID_example"; // String | API Key ID (public component).
        try {
            APIKey result = apiInstance.aPIKeyDisable(apiKeyID);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling APIKeyApi#aPIKeyDisable");
            e.printStackTrace();
        }
    }
}

Documentation for API Endpoints

All URIs are relative to https://localhost/api/v1

Class Method HTTP request Description
APIKeyApi aPIKeyDisable POST /apiKey/disable Disable an API Key.
APIKeyApi aPIKeyEnable POST /apiKey/enable Enable an API Key.
APIKeyApi aPIKeyGet GET /apiKey Get your API Keys.
APIKeyApi aPIKeyNew POST /apiKey Create a new API Key.
APIKeyApi aPIKeyRemove DELETE /apiKey Remove an API Key.
AnnouncementApi announcementGet GET /announcement Get site announcements.
AnnouncementApi announcementGetUrgent GET /announcement/urgent Get urgent (banner) announcements.
ChatApi chatGet GET /chat Get chat messages.
ChatApi chatGetChannels GET /chat/channels Get available channels.
ChatApi chatGetConnected GET /chat/connected Get connected users.
ChatApi chatNew POST /chat Send a chat message.
ExecutionApi executionGet GET /execution Get all raw executions for your account.
ExecutionApi executionGetTradeHistory GET /execution/tradeHistory Get all balance-affecting executions. This includes each trade, insurance charge, and settlement.
FundingApi fundingGet GET /funding Get funding history.
InstrumentApi instrumentGet GET /instrument Get instruments.
InstrumentApi instrumentGetActive GET /instrument/active Get all active instruments and instruments that have expired in <24hrs.
InstrumentApi instrumentGetActiveAndIndices GET /instrument/activeAndIndices Helper method. Gets all active instruments and all indices. This is a join of the result of /indices and /active.
InstrumentApi instrumentGetActiveIntervals GET /instrument/activeIntervals Return all active contract series and interval pairs.
InstrumentApi instrumentGetCompositeIndex GET /instrument/compositeIndex Show constituent parts of an index.
InstrumentApi instrumentGetIndices GET /instrument/indices Get all price indices.
InsuranceApi insuranceGet GET /insurance Get insurance fund history.
LeaderboardApi leaderboardGet GET /leaderboard Get current leaderboard.
LiquidationApi liquidationGet GET /liquidation Get liquidation orders.
NotificationApi notificationGet GET /notification Get your current notifications.
OrderApi orderAmend PUT /order Amend the quantity or price of an open order.
OrderApi orderAmendBulk PUT /order/bulk Amend multiple orders for the same symbol.
OrderApi orderCancel DELETE /order Cancel order(s). Send multiple order IDs to cancel in bulk.
OrderApi orderCancelAll DELETE /order/all Cancels all of your orders.
OrderApi orderCancelAllAfter POST /order/cancelAllAfter Automatically cancel all your orders after a specified timeout.
OrderApi orderClosePosition POST /order/closePosition Close a position. [Deprecated, use POST /order with execInst: 'Close']
OrderApi orderGetOrders GET /order Get your orders.
OrderApi orderNew POST /order Create a new order.
OrderApi orderNewBulk POST /order/bulk Create multiple new orders for the same symbol.
OrderBookApi orderBookGet GET /orderBook Get current orderbook [deprecated, use /orderBook/L2].
OrderBookApi orderBookGetL2 GET /orderBook/L2 Get current orderbook in vertical format.
PositionApi positionGet GET /position Get your positions.
PositionApi positionIsolateMargin POST /position/isolate Enable isolated margin or cross margin per-position.
PositionApi positionTransferIsolatedMargin POST /position/transferMargin Transfer equity in or out of a position.
PositionApi positionUpdateLeverage POST /position/leverage Choose leverage for a position.
PositionApi positionUpdateRiskLimit POST /position/riskLimit Update your risk limit.
QuoteApi quoteGet GET /quote Get Quotes.
QuoteApi quoteGetBucketed GET /quote/bucketed Get previous quotes in time buckets.
SchemaApi schemaGet GET /schema Get model schemata for data objects returned by this API.
SchemaApi schemaWebsocketHelp GET /schema/websocketHelp Returns help text & subject list for websocket usage.
SettlementApi settlementGet GET /settlement Get settlement history.
StatsApi statsGet GET /stats Get exchange-wide and per-series turnover and volume statistics.
StatsApi statsHistory GET /stats/history Get historical exchange-wide and per-series turnover and volume statistics.
StatsApi statsHistoryUSD GET /stats/historyUSD Get a summary of exchange statistics in USD.
TradeApi tradeGet GET /trade Get Trades.
TradeApi tradeGetBucketed GET /trade/bucketed Get previous trades in time buckets.
UserApi userCancelWithdrawal POST /user/cancelWithdrawal Cancel a withdrawal.
UserApi userCheckReferralCode GET /user/checkReferralCode Check if a referral code is valid.
UserApi userConfirm POST /user/confirmEmail Confirm your email address with a token.
UserApi userConfirmEnableTFA POST /user/confirmEnableTFA Confirm two-factor auth for this account. If using a Yubikey, simply send a token to this endpoint.
UserApi userConfirmWithdrawal POST /user/confirmWithdrawal Confirm a withdrawal.
UserApi userDisableTFA POST /user/disableTFA Disable two-factor auth for this account.
UserApi userGet GET /user Get your user model.
UserApi userGetAffiliateStatus GET /user/affiliateStatus Get your current affiliate/referral status.
UserApi userGetCommission GET /user/commission Get your account's commission status.
UserApi userGetDepositAddress GET /user/depositAddress Get a deposit address.
UserApi userGetMargin GET /user/margin Get your account's margin status. Send a currency of &quot;all&quot; to receive an array of all supported currencies.
UserApi userGetWallet GET /user/wallet Get your current wallet information.
UserApi userGetWalletHistory GET /user/walletHistory Get a history of all of your wallet transactions (deposits, withdrawals, PNL).
UserApi userGetWalletSummary GET /user/walletSummary Get a summary of all of your wallet transactions (deposits, withdrawals, PNL).
UserApi userLogout POST /user/logout Log out of BitMEX.
UserApi userLogoutAll POST /user/logoutAll Log all systems out of BitMEX. This will revoke all of your account's access tokens, logging you out on all devices.
UserApi userMinWithdrawalFee GET /user/minWithdrawalFee Get the minimum withdrawal fee for a currency.
UserApi userRequestEnableTFA POST /user/requestEnableTFA Get secret key for setting up two-factor auth.
UserApi userRequestWithdrawal POST /user/requestWithdrawal Request a withdrawal to an external wallet.
UserApi userSavePreferences POST /user/preferences Save user preferences.
UserApi userUpdate PUT /user Update your password, name, and other attributes.

Documentation for Models

Documentation for Authorization

Authentication schemes defined for the API:

apiKey

  • Type: API key
  • API key parameter name: api-key
  • Location: HTTP header

apiNonce

  • Type: API key
  • API key parameter name: api-nonce
  • Location: HTTP header

apiSignature

  • Type: API key
  • API key parameter name: api-signature
  • Location: HTTP header

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Author

[email protected]